Документация Engee

Модели-ссылки (Model Reference)

В данной демонстрации мы на простом примере разберём, как использовать блок Model в Engee.

Сама технология модели-ссылки – это ссылка на другую модель с использованием блока Model. Такие модели используются для создания иерархии системной модели. Модели-ссылки идеально подходят для повторного использования подсистем, модульного тестирования, параллельных сборок и больших систем.

Для реализации нашей демонстрации нам понадобятся две модели: главная модель и модель-ссылка.

image.png

В нашем примере мы реализовали при помощи простых элементов счётчик с двумя входными портами, которые определяют шаг и максимальное значения счётчика.

image.png

После этого мы можем переходить к разработке основной модели, в которой будем ссылаться на реализованный счётчик с помощью блока Model.

Для подключения модели воспользуемся функцией выбора модели.

image_2.png

Теперь в открывшемся окне файлового менеджера выбираем модель реализованного нами счётчика.

image_3.png

В результате у нас получилась основная модель с подсистемой, которая хранится в отдельном файле. При такой реализации мы можем переиспользовать этот счётчик множество раз внутри одного проекта. При этом, изменив логику в референсной подистеме, мы применим эти изменения ко всем блокам, ссылающимся на исходную модель.

image.png

Теперь запустим нашу модель и проанализируем корректность работы счётчика.

function run_model( name_model, path_to_folder )

    Path = path_to_folder * "/" * name_model * ".engee"

    if name_model in [m.name for m in engee.get_all_models()] # Проверка условия загрузки модели в ядро
        model = engee.open( name_model ) # Открыть модель
        model_output = engee.run( model, verbose=true ); # Запустить модель
    else
        model = engee.load( Path, force=true ) # Загрузить модель
        model_output = engee.run( model, verbose=true ); # Запустить модель
        engee.close( name_model, force=true ); # Закрыть модель
    end

    return model_output
end
run_model (generic function with 1 method)
run_model("model", @__DIR__)
Building...
Progress 100%
Dict{String, DataFrames.DataFrame} with 1 entry:
  "Model.Cnt" => 11×2 DataFrame…

Считаем залогированные данные.

Data = collect(simout["model/Model.Cnt"]);

Отобразим результаты моделирования.

using Plots
plot(Data.time, Data.value, linetype=:steppre)

interactive-scripts/images/base_simulation_Model_Reference/9bfe8c9a9cb528879277af7408e6e7542c122528

Как мы видим из графика выше, счётчик действительно выполняет приращение с шагом по единице, и при этом максимальное значение счётчика равно 5.

Вывод

В данном примере мы разобрали возможности использования моделий-ссылок и показали, как их применить к вашим проектам. Данный метод проектирования систем существенно упрощает работу с вашими проектами, а также сокращает время, затрачиваемое на редактирование блоков в случаи внесения изменений в проект.