Обратные вызовы модели

Обратные вызовы модели выполняются в указанных точках действия, например после загрузки или сохранения модели.

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

Создание обратных вызовов модели

В редакторе Simulink ® откройте инспектор свойств. На вкладке «Моделирование» в группе «Проект» выберите «Инспектор свойств».
При отсутствии выбора на верхнем уровне модели на вкладке Свойства (Properties) в разделе Обратные вызовы (Callbacks) выберите обратный вызов, который требуется задать.
В поле введите функции, которые должен выполнять обратный вызов.

Для программного создания обратного вызова модели используйте set_param назначение кода MATLAB ® параметру обратного вызова модели. См. раздел Параметры обратного вызова модели

Обратные вызовы ссылочной модели

В иерархии моделей выполнение обратных вызовов отражает порядок, в котором верхняя модель и модели, на которые она ссылается, выполняют свои обратные вызовы. Например, предположим:

Модель A:
- Ссылается на модель B в режиме ускорителя.
- Имеет PostLoadFcn обратный вызов, который создает переменные в рабочей области MATLAB.
- Имеет Rebuild параметр конфигурации имеет значение Always, If changes detected, или If any changes in known dependencies detected.
Модель B:
- Имеет CloseFcn обратный вызов, который очищает рабочую область MATLAB.
- Не был построен или устарел.

Моделирование модели A запускает перестроение ссылочной модели B. Когда Simulink перестраивает модель B, она открывает и закрывает модель B, которая вызывает модель B CloseFcn обратный вызов. CloseFcn удаляет рабочую область MATLAB, включая переменные, созданные моделью A OpenFcn обратный вызов.

Вместо использования CloseFcn обратный вызов для модели B, можно использовать StopFcn обратный вызов в модели A для очистки переменных, используемых моделью из рабочей области MATLAB. Кроме того, во избежание необходимости использования переменных в базовой рабочей области для данных можно использовать словарь данных.

Если модель ссылается на несколько экземпляров одной модели в обычном режиме, обратные вызовы выполняются для каждого экземпляра.

Для моделей, на которые ссылается режим ускорения, Simulink не выполняет некоторые обратные вызовы. Если все обновлено и для параметра конфигурации Rebuild установлено значение If any changes in known dependencies detected, то ссылочная модель не компилируется и ее InitFcn обратные вызовы не выполняются. Обратные вызовы, такие как StartFcn и StopFcn не выполняются, поскольку ссылочные модели в режиме ускорителя используют S-функцию, которая запускается и останавливается вместо ссылочной модели.

Примечание

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

Модель InitFcn необходимо избегать обратных вызовов, которые редактируют структуру модели. Иногда simulink может выполняться или игнорироваться на основе состояния загрузки модели.

Параметры обратного вызова модели

Параметры обратного вызова загрузки и закрытия модели

Параметр обратного вызова модели При выполнении

Параметр обратного вызова модели	При выполнении
`PreLoadFcn`	Этот обратный вызов выполняется перед загрузкой модели. Не использовать параметры модели в `PreLoadFcn` обратный вызов модели, поскольку параметры загружаются после загрузки модели. Вместо этого используйте `PostLoadFcn` обратный вызов для работы с параметрами модели при загрузке модели. Определение кода обратного вызова для этого параметра полезно для загрузки переменных, используемых моделью. Если требуется вызвать модель из файла MATLAB без открытия модели, используйте `load_system` функция, чтобы `PreLoadFcn` выполняется. Примеры см. в разделе: Загрузить переменные при открытии модели Введение в управление данными со ссылкой на модель Управление целями моделирования для ссылочных моделей Ограничения включают: Для `PreLoadFcn` обратный вызов, `get_param` не возвращает значения параметров модели, поскольку модель еще не загружена. Вместо этого `get_param` возвращает: Значение по умолчанию для стандартного параметра модели, например `solver` Сообщение об ошибке для параметра модели, добавленного с `add_param` Программный доступ к областям не поддерживается.
`PostLoadFcn`	После загрузки модели. Определение кода обратного вызова для этого параметра может быть полезно для создания интерфейса, требующего загруженной модели. Ограничения включают: При внесении структурных изменений с помощью `PostLoadFcn`, функция не задает модель `Dirty` для указания несохраненных изменений. При закрытии модели Simulink не запрашивает сохранение. Программный доступ к областям не поддерживается. Поскольку редактор Simulink открывается после выполнения этого обратного вызова, `PostLoadFcn` обратный вызов не подходит для настройки вида модели, например, для задания коэффициента масштабирования. Сохраните информацию о масштабировании вместе с моделью, чтобы открыть ее с определенным коэффициентом масштабирования.
`CloseFcn`	Перед закрытием блок-схемы. Любой `ModelCloseFcn` и `DeleteFcn` обратные вызовы, заданные для блоков в модели, вызываются до модели `CloseFcn` обратный вызов. `DestroyFcn` обратный вызов любых блоков в модели вызывается после модели `CloseFcn` обратный вызов.

PreLoadFcn

Этот обратный вызов выполняется перед загрузкой модели.

Не использовать параметры модели в PreLoadFcn обратный вызов модели, поскольку параметры загружаются после загрузки модели. Вместо этого используйте PostLoadFcn обратный вызов для работы с параметрами модели при загрузке модели.

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

Если требуется вызвать модель из файла MATLAB без открытия модели, используйте load_system функция, чтобы PreLoadFcn выполняется.

Примеры см. в разделе:

Ограничения включают:

Для PreLoadFcn обратный вызов, get_param не возвращает значения параметров модели, поскольку модель еще не загружена. Вместо этого get_param возвращает:
- Значение по умолчанию для стандартного параметра модели, например solver
- Сообщение об ошибке для параметра модели, добавленного с add_param
Программный доступ к областям не поддерживается.

PostLoadFcn

После загрузки модели.

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

Ограничения включают:

При внесении структурных изменений с помощью PostLoadFcn, функция не задает модель Dirty для указания несохраненных изменений. При закрытии модели Simulink не запрашивает сохранение.
Программный доступ к областям не поддерживается.

Поскольку редактор Simulink открывается после выполнения этого обратного вызова, PostLoadFcn обратный вызов не подходит для настройки вида модели, например, для задания коэффициента масштабирования. Сохраните информацию о масштабировании вместе с моделью, чтобы открыть ее с определенным коэффициентом масштабирования.

CloseFcn

Перед закрытием блок-схемы.

Любой ModelCloseFcn и DeleteFcn обратные вызовы, заданные для блоков в модели, вызываются до модели CloseFcn обратный вызов. DestroyFcn обратный вызов любых блоков в модели вызывается после модели CloseFcn обратный вызов.

Сохранение параметров обратного вызова модели

Параметр обратного вызова модели	При выполнении
`PreSaveFcn`	Перед сохранением модели.
`PostSaveFcn`	После сохранения модели. Примечание При внесении структурных изменений с помощью `PostSaveFcn`, функция не задает модель `Dirty` для указания несохраненных изменений. При закрытии модели Simulink не запрашивает сохранение.

Параметры обратного вызова моделирования модели

Параметр обратного вызова модели	При выполнении
`InitFcn`	Вызывается во время фазы обновления перед оценкой параметров блока. Это вызывается во время обновления модели и моделирования. Для получения дополнительной информации о `InitFcn` обратный вызов, см. функцию инициализации Примеры см. в разделе: Создание программных гиперссылок Отслеживание объекта с помощью кода MATLAB
`StartFcn`	Вызывается перед этапом моделирования. Это не вызывается во время обновления модели.
`PauseFcn`	После моделирования приостанавливается.
`ContinueFcn`	Перед продолжением моделирования.
`StopFcn`	После завершения моделирования. Выходные данные записываются в переменные и файлы рабочей области перед `StopFcn` выполняется. Выходные данные моделирования недоступны в `StopFcn` обратные вызовы для моделирования командной строки.

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