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

Открыть пример в Engee

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

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

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

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

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

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

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

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

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

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%
Progress 100%

Dict{String, DataFrame} with 1 entry:
  "Model.Cnt" => 11×2 DataFrame…

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

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

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

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

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

Можно добавить бесконечное количество таких счётчиков. На примере ниже показана модель с двумя параллельными счётчиками.

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

run_model("model_2", @__DIR__)

Building...
Progress 100%
Progress 100%

Dict{String, DataFrame} with 2 entries:
  "Model.Cnt"   => 11×2 DataFrame…
  "Model-1.Cnt" => 11×2 DataFrame…

Data_1 = collect(simout["model_2/Model.Cnt"]);
Data_2 = collect(simout["model_2/Model-1.Cnt"]);

plot(Data_1.time, Data_1.value, linetype=:steppre)
plot!(Data_2.time, Data_2.value, linetype=:steppre)

Как мы видим, в данном случае два счётчика отрабатывают параллельно и имеют различное максимальное значение.

Вывод

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

Блоки, использованные в примере

• Delay
• Inport
• Relational Operator
• Switch