Model Reference Conversion Advisor

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

Описание

Model Reference Conversion Advisor преобразует подсистемы, включая условные и ссылочные подсистемы, в модели-ссылки.

Преобразование подсистем в ссылочные модели выгодно для моделирования больших, сложных систем и для командной разработки. Многие большие модели используют комбинацию подсистем и ссылочных моделей. Чтобы решить, преобразовывать ли подсистему в модель-ссылку, смотрите Выбор среди типов компонентов модели.

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

Модель-ссылка Conversion Advisor не поддерживает преобразование для некоторых типов подсистем. Для примера:

  • Subsystem блоки с Simscape™ Multibody™ компонентами, которые пересекают контур подсистемы

  • Асинхронные подсистемы - для преобразования асинхронных подсистем в ссылочные модели, принимающие асинхронные вызовы функций, см. Раздел «Ограничения асинхронной Поддержки» (Simulink Coder).

The Model Reference Conversion Advisor window.

Откройте Модель-ссылка Conversion Advisor

  • В редакторе Simulink выберите блок Subsystem. На панели инструментов Simulink, на вкладке Subsystem Block, выберите Convert > Model Block.

  • В MATLAB® командное окно, используйте Simulink.SubSystem.convertToModelReference функция со 'UseConversionAdvisor' для аргумента задано значение true.

Примеры

расширить все

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

Когда вы открываете советник, в левой панели, выбирается верхний узел. Этот узел идентифицирует блок Subsystem, который советник преобразует в ссылку на модель, и обеспечивает параметры входа преобразования. Можно использовать значения параметров по умолчанию или изменить значения, чтобы настроить преобразование.

Входной параметрОписание

New model name

Советник предоставляет имя модели на основе имени Subsystem блока, которое является уникальным в пути MATLAB.

Имя модели не может превышать 59 символов. Для получения дополнительной информации см. «Имена моделей».

Совет

Если советник генерирует ошибку, указывающую, что целевая ссылочная модель уже существует, используйте параметр New model name, чтобы задать новое имя файла.

Conversion data file name

Советник создает файл для хранения данных, созданных во время преобразования. По умолчанию советник использует имя модели в начале имени файла и добавляет имя файла с _conversion_data.mat. Для примера, для подсистемы в модели с именем myModel, имя файла преобразования myModel_conversion_data.mat.

Можно сохранить данные преобразования в MAT-файле (по умолчанию) или ФАЙЛ MATLAB. Если вы используете .m расширение файла, советник сериализует все переменные в файл MATLAB.

Примечание

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

Fix errors automatically (if possible)

По умолчанию, если при проверке advisor обнаруживается ошибка, которую может исправить advisor, advisor предоставляет кнопку Fix. Щелкните его, чтобы советник решил проблему.

Если вы включите этот параметр, советник исправит все возможные ошибки преобразования, не отображая кнопку Fix.

Replace the content of a subsystem with a Model block

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

  • Если вы используете автоматические исправления, то советник заменяет Subsystem блок на Model блок, если автоматические исправления не меняют входные или выходные порты. Если порты изменяются, советник включает содержимое подсистемы в блок Model и вставляет его в блок Subsystem.

  • Если вы не используете автоматические исправления, то советник заменяет Subsystem блок на Model блок.

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

Copy code mappings

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

Информация отображения кода включает в себя строения элементов данных моделей для генерации кода. Этот параметр не влияет на симуляцию.

Для получения дополнительной информации смотрите Преобразовать Подсистему в Ссылочную Модель и Сгенерировать Код (Simulink Coder).

Model block simulation mode

Режим симуляции для нового блока Model, который ссылается на ссылочную модель.

  • Normal (по умолчанию)

  • Accelerator

Check simulation results after conversion

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

Чтобы использовать эту опцию, перед выполнением преобразования:

  • Включите регистрацию сигналов для интересующих выходов сигналов.

  • Выберите Replace the content of a subsystem with a Model block.

  • Установите опцию Model block simulation mode в советнике в том же режиме симуляции, что и исходная модель.

  • Задайте Stop time, Absolute tolerance и Relative tolerance.

Чтобы увидеть результаты после завершения преобразования, нажмите View comparison results. Консультант отображает результаты сравнения в Данные моделирования Inspector. Для получения дополнительной информации смотрите Сравнение Результатов симуляции до и после преобразования.

Stop time

По умолчанию советник использует время остановки верхней модели, если только время остановки верхней модели не inf. Если время остановки верхней модели infсоветник использует время остановки по умолчанию 10.

Чтобы использовать эту опцию, выберите Check simulation results after conversion.

Absolute tolerance

Абсолютный допуск сигнала для сравнения прогонов симуляции. Значение по умолчанию является 1e-06.

Чтобы использовать эту опцию, выберите Check simulation results after conversion.

Relative tolerance

Относительный допуск сигнала для сравнения прогонов симуляции. Значение по умолчанию является 1e-03.

Чтобы использовать эту опцию, выберите Check simulation results after conversion.

Show report after run

После завершения преобразования откройте отчет, в котором результирующие настройки преобразования и результаты.

Модель-ссылка Conversion Advisor может пройти каждую проверку автоматически.

  1. После настройки опций преобразования подсистем нажмите Convert.

    Советник по преобразованию Модели-ссылки выполняет каждую проверку автоматически.

  2. Решает любые вопросы, о которых сообщает советник. Советник предоставляет кнопку Fix для любых проблем, которые он может исправить автоматически.

  3. После устранения выявленных проблем нажмите кнопку Continue.

После того, как Модель-ссылка Conversion Advisor успешно запустила все проверки, он завершит преобразование.

Проверьте, что все входные параметры преобразования действительны.

Для получения информации о входных параметрах преобразования смотрите Set Subsystem Conversion Options.

  1. На левой панели выберите узел Check conversion input parameters.

  2. Нажмите кнопку Run This Task.

  3. Решает любые вопросы, о которых сообщает советник. Советник предоставляет кнопку Fix для любых проблем, которые он может исправить автоматически.

  4. После устранения выявленных проблем нажмите кнопку Continue.

Проверьте, что строения модели соответствуют требованиям к ссылкам на модели. Эта проверка идентифицирует настройки параметров конфигурации модели, которые не действительны для моделей-ссылок.

  1. На левой панели выберите узел Check model configurations.

  2. Нажмите кнопку Run This Task.

  3. Решает любые вопросы, о которых сообщает советник. Советник предоставляет кнопку Fix для любых проблем, которые он может исправить автоматически.

  4. После устранения выявленных проблем нажмите кнопку Continue.

Проверьте, соответствует ли интерфейс подсистемы требованиям к моделям-ссылкам.

  1. На левой панели выберите узел Check subsystem interface.

  2. Нажмите кнопку Run This Task.

    Советник проверяет, что тип подсистемы может быть преобразован советником. Затем выполняется проверка соответствия интерфейсов к конкретным типам подсистем, таким как маскированные подсистемы, требованиям преобразования.

  3. Решает любые вопросы, о которых сообщает советник. Советник предоставляет кнопку Fix для любых проблем, которые он может исправить автоматически.

  4. После устранения выявленных проблем нажмите кнопку Continue.

Проверьте, соответствует ли содержимое подсистемы модели-ссылки требованиям.

  1. На левой панели выберите узел Check subsystem content.

  2. Нажмите кнопку Run This Task.

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

  3. Решает любые вопросы, о которых сообщает советник. Советник предоставляет кнопку Fix для любых проблем, которые он может исправить автоматически.

  4. После устранения выявленных проблем нажмите кнопку Continue.

После успешного выполнения всех проверок завершите преобразование.

  1. На левой панели выберите узел Complete conversion.

  2. Нажмите кнопку Run This Task.

    Советник по преобразованию Модели-ссылки:

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

    • Создает Simulink.Bus объекты, Simulink.Signal объекты и настраиваемые параметры, которые требуются ссылочной модели.

    • По умолчанию заменяет Subsystem блок на Model блок, который ссылается на новую модель.

    • Вставляет Model блок в Subsystem блок, если автоматическое исправление добавленных портов к интерфейсу Model блока.

    • Создает сводный отчет преобразования HTML в slprj папка. В этом отчете результирующие результаты процесса преобразования, включая результаты исправлений, выполненных консультантом. Этот отчет также описывает элементы, которые копирует советник.

    • Опционально проверяет согласованность результатов симуляции до и после преобразования.

    • Копирует следующие элементы из исходной модели в новую ссылочную модель.

      • Конфигурация модели - Если родительская модель использует:

        • При конфигурации модели, которая не является ссылочной конфигурацией модели, советник копирует всю конфигурацию модели в ссылку модели

        • Ссылочная конфигурация модели, затем и родительская, и ссылочная модели используют ту же ссылку конфигурации модели

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

      • Ссылки требований - советник копирует ссылки требований, созданные с помощью программного обеспечения Simulink Requirements™, в блок Model из исходного блока Subsystem.

Если вы не удовлетворены результатами преобразования, можно восстановить модель в ее начальном состоянии. После успешного запуска проверки Complete conversion используйте Click here to restore the original model ссылку.

Если вы выбрали Check simulation results after conversion, можно просмотреть результаты с помощью Click here to view the comparison results ссылки.

Если вы выбрали Check simulation results after conversion, Модель-ссылка Conversion Advisor обеспечивает сравнение результатов моделирования верхней модели до и после преобразования.

После успешного запуска проверки Complete conversion нажмите Click here to view the comparison results. Результаты отображаются в Simulation Data Inspector. Зеленая галочка указывает, что результаты симуляции находятся в пределах допуска между базовой моделью и моделью с новой ссылочной моделью.

The Simulation Data Inspector compares a logged signal before and after conversion.

Для получения дополнительной информации см. «Сравнение данных моделирования».

Введенный в R2014a