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

Разработка и отладка моделей

Смотрите также:
Навыки Engee MIND
Как моделировать в Engee

Сценарий предназначен для построения модели по описанию системы, изменения существующей схемы и поиска причин ошибок расчета. Основной навык — engee_model.

Исходные данные

Укажите назначение модели, уравнения или физическую схему, параметры с единицами измерения, входные воздействия и начальные условия. Для существующей модели передайте .engee или ее путь в сессии. Добавьте длительность расчета, требования к шагу/решателю, необходимые выходные сигналы и критерии приемки.

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

Создание модели

  1. Агент проверяет и при необходимости запускает среду, загружает engee_model.

  2. Разбирает описание системы, выделяет состояния, входы, выходы и обратные связи.

  3. Создает отдельный каталог проекта в /user/, создает модель и сразу сохраняет .engee.

  4. Находит блоки через block_search, уточняет параметры и порты через block_info.

  5. Собирает схему, задает параметры, соединения и расположение блоков.

  6. Добавляет To Workspace для нужных выходов с уникальными именами переменных.

  7. Выполняет расчет, получает данные через collect, проверяет численную и физическую корректность.

  8. Сохраняет модель, результаты и отчет; выдает файлы по запросу.

Пример задачи

Создай в Engee модель апериодического звена `G(s) = 2 / (0.5s + 1)` с нулевым начальным состоянием. На вход подай единичную ступень в момент 0 с. Рассчитай 5 с и сохрани выход через To Workspace. Сравни его с `y(t) = 2(1 - exp(-t/0.5))`: максимальная абсолютная ошибка на согласованной сетке не должна превышать 0.01. Сохрани проект в `/user/FirstOrderDemo/`, выдай `.engee`, CSV, график и протокол проверки.

Числа в этом примере — постановка учебного теста, а не результат выполненного моделирования.

Отладка существующей модели

Сообщите наблюдаемую проблему, ожидаемое поведение, условия запуска и допустимые изменения. Например:

Открой `/user/Drive/Drive.engee`. После запуска не появляются данные скорости. Найди причину через engee_diagnose, проверь To Workspace, имена переменных и логи инициализации. Не изменяй физические параметры. Исправленную модель сохрани отдельным файлом и подтверди результат повторным расчетом.

Агент должен отличать ошибку построения схемы от отсутствия настроенного вывода данных и от численной неустойчивости. Скриншот помогает проверить соединения и читаемость; соответствие критериям подтверждают данные текущего прогона.

Критерии готовности

  • Сохраненный .engee открывается и содержит нужную схему.

  • Расчет завершен, получены непустые данные требуемых сигналов.

  • Данные конечны; шаг времени, единицы и диапазоны соответствуют задаче.

  • Сравнение с эталоном выполнено по заданным метрикам и допускам.

  • Отчет содержит фактические настройки, найденные ошибки и оставшиеся ограничения.

Если используется собственный алгоритм, агент может выбрать навык engee_ngfunction_developement для Engee Function или engee_cfunction_developement для C Function. Такой блок проверяется в тестовой модели с известными входами и граничными режимами.