systemcomposer.importModel

Импортируйте информацию о модели из таблиц MATLAB

Описание

пример

archModel = systemcomposer.importModel(modelName,components,ports,connections,portInterfaces,requirementLinks) создает новую модель архитектуры на основе MATLAB® таблицы, в которых указаны компоненты, порты, соединения, интерфейсы портов и ссылки требований. Единственными необходимыми входными параметрами являются modelName и components таблица. Для пустых входных параметров таблицы введите table.emptyоднако конечные пустые таблицы игнорируются и не должны вводиться. Для импорта базовой модели архитектуры смотрите Define a Basic Architecture. Для порядка requirementLinks, вам нужен Simulink® Requirements™ лицензию.

archModel = systemcomposer.importModel(importStruct) создает новую модель архитектуры, основанную на структуре таблиц MATLAB, которая задает компоненты, порты, соединения, интерфейсы портов и требования.

[archModel,idMappingTable,importLog,errorLog] = systemcomposer.importModel(___) создает новую модель архитектуры с выходными аргументами idMappingTable с информацией о таблице, importLog отображение информации об импорте и errorLog для отображения информации об ошибке импорта.

Примеры

свернуть все

В System Composer™ архитектура полностью определяется тремя наборами информации:

  • Информация о компоненте

  • Информация о порте

  • Информация о соединении

Можно импортировать архитектуру в System Composer, если эта информация задана или преобразована в таблицы MATLAB ®.

В этом примере информация об архитектуре простой системы БПЛА определяется в электронной таблице Excel и используется для создания модели архитектуры System Composer. Это также связывает элементы с заданным требованием к уровню системы. Можно изменить файлы в этом примере, чтобы импортировать архитектуры, определенные во внешних инструментах, когда данные включают необходимую информацию. В примере также показано, как экспортировать эту архитектурную информацию из модели архитектуры System Composer в электронную таблицу Excel ®.

Данные определения архитектуры

Можно охарактеризовать архитектуру как сеть компонентов и импорта путем определения компонентов, портов, соединений, интерфейсов и ссылок требований в таблицах MATLAB. The components таблица должна включать имя, уникальный идентификатор и идентификатор родительского компонента для каждого компонента. Это может также включать другую соответствующую информацию, необходимую для построения иерархии архитектуры для ссылочных моделей, и имен классификатора стереотипов. The ports таблица должна включать имя порта, направление, компонент и идентификатор порта. Информация о интерфейсе порта также может потребоваться для назначения портов компонентам. The connections таблица содержит информацию для соединения портов. Как минимум, эта таблица должна включать идентификатор соединения, идентификатор исходного порта и идентификатор порта назначения.

Systemcomposer.importModel (importModelName) API:

  • Читает имена стереотипов из components таблица и загружает профили

  • Создает компоненты и присоединяет порты

  • Создает соединения с помощью карты соединений

  • Устанавливает интерфейсы к портам

  • Связывает элементы с заданными требованиями

  • Сохранение ссылок на модели

  • Сохраняет модель архитектуры

% Instantiate adapter class to read from Excel.
modelName = 'simpleUAVArchitecture';
% importModelFromExcel function reads the Excel file and creates the MATLAB tables.
importAdapter = ImportModelFromExcel('SmallUAVModel.xls','Components', ...
    'Ports','Connections','PortInterfaces','RequirementLinks');
importAdapter.readTableFromExcel();

Импорт архитектуры

model = systemcomposer.importModel(modelName,importAdapter.Components, ...
    importAdapter.Ports,importAdapter.Connections,importAdapter.Interfaces, ...
    importAdapter.RequirementLinks);
% Auto-arrange blocks in the generated model
Simulink.BlockDiagram.arrangeSystem(modelName);

Экспорт архитектуры

Можно экспортировать архитектуру в таблицы MATLAB, а затем преобразовать во внешний файл

exportedSet = systemcomposer.exportModel(modelName);
% The output of the function is a structure that contains the component table, port table,
% connection table, the interface table, and the requirement links table.
% Save the above structure to Excel file.
SaveToExcel('ExportedUAVModel',exportedSet);

Закройте модель

bdclose(modelName);

Входные параметры

свернуть все

Имя создаваемой модели, заданное как вектор символов.

Пример: 'importedModel'

Типы данных: char

Моделируйте информацию о компоненте, заданную как таблица MATLAB. Таблица компонентов должна включать столбцы Name, ID, и ParentID. Чтобы задать ComponentType как Variant, Composition (по умолчанию), StateflowBehavior, или Behavior (ссылочные компоненты) и задать ReferenceModelName, см. «Импорт исполнительных компонентов», «Поведение Stateflow» или «Ссылочные компоненты». Применение стереотипов с помощью StereotypeNames и задайте значения свойств для компонентов, см. «Применение стереотипов» и «Задание значений свойств на импортированной модели».

Типы данных: table

Моделируйте информацию о порте, заданную как таблица MATLAB. Таблица портов должна включать столбцы Name, Direction, ID, и CompID. Дополнительный столбец InterfaceID задает интерфейс. portInterfaces может также потребоваться информация для назначения интерфейсов портам.

Типы данных: table

Моделируйте информацию о соединениях, заданную как таблица MATLAB. Таблица соединений должна содержать столбцы Name, ID, SourcePortID, и DestPortID. Чтобы задать SourceElement или DestinationElement для порта архитектуры см. «Задание элементов на портале архитектуры». Присвоение стереотипа с помощью необязательного столбца StereotypeNames.

Типы данных: table

Моделируйте информацию о интерфейсах портов, заданную как таблица MATLAB. Таблица интерфейсов портов должна включать столбцы Name, ID, ParentID, DataType, Dimensions, Units, Complexity, Minimum, и Maximum. Для импорта интерфейсов и сопоставления портов с интерфейсами смотрите Import Interfaces и Map Ports to Interfaces. Назначьте стереотип с помощью необязательного столбца StereotypeNames.

Типы данных: table

Моделируйте требования ссылок информацию, заданную как таблица MATLAB. Таблица ссылок требований должна включать столбцы Label, ID, SourceID, DestinationType, DestinationID, и Type. Для получения примера смотрите Присвоение Ссылки требований на импортированных Моделях. Чтобы обновить ссылки требования к ссылкам из импортированного файла и интегрировать их в модель, смотрите Обновление ссылок требования к ссылкам из импортированного файла. Необязательные столбцы включают: DestinationArifact, SourceArtifact, ReferencedReqID, Keywords, CreatedOn, CreatedBy, ModifiedOn, ModifiedBy, и Revision. Для импорта requirementLinks требуется лицензия Simulink Requirements таблица в модель System Composer™ architecture.

Типы данных: table

Моделируйте таблицы, заданные как структура, содержащая таблицы components, ports, connections, portInterfaces, и requirementLinks, Только components таблица обязательна.

Типы данных: struct

Выходные аргументы

свернуть все

Указатель на модель архитектуры, заданный как systemcomposer.arch.Architecture объект.

Отображение пользовательских идентификаторов и внутренних UUID элементов, возвращаемое как struct таблицы MATLAB.

Типы данных: struct

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

Типы данных: char

Ошибки, сообщенные в процессе импорта, возвращаются как массив сообщений MException объекты. Вы можете получить текст ошибки, позвонив в getString метод на каждом MException объект. Для примера, errorLog.getString используется для получения ошибок, сообщаемых как строка.

Подробнее о

свернуть все

Определения

ТерминОпределениеПриложениеДополнительная информация
архитектураАрхитектура System Composer представляет систему компонентов и то, как они взаимодействуют друг с другом структурно и поведенчески. Представлять определенные архитектуры можно с помощью альтернативных представлений.

Различные типы архитектур описывают различные аспекты систем:

  • Функциональная архитектура описывает поток данных в системе.

  • Логическая архитектура описывает предполагаемую операцию системы.

  • Физическая архитектура описывает платформу или оборудование в системе.

Составьте архитектуру визуально
модельМодель System Composer является файлом, содержащим архитектурную информацию, включая компоненты, порты, соединители, интерфейсы и поведение.

Выполните операции над моделью:

  • Извлеките архитектуру корневого уровня, содержащуюся в модели.

  • Применить профили.

  • Соедините словари данных интерфейса.

  • Сгенерируйте образцы из архитектуры модели.

Модели System Composer хранятся как .slx файлы.

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

Существуют различные типы портов:

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

  • Архитектуры порты являются портами на контур системы, будь то контур внутри компонента или общая модель архитектуры.

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

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

Элементы интерфейса описывают разложение интерфейса:

  • Контакты или провода в соединителе или обвязке.

  • Сообщения, передаваемые через шину.

  • Структуры данных, общие между компонентами.

Присвоение интерфейсов портам
словарь интерфейсаСловарь данных интерфейса является сводным списком всех интерфейсов в архитектуре и где они используются. Локальные интерфейсы в модели System Composer могут быть сохранены в словаре данных интерфейса с помощью редактора интерфейсов.Словари интерфейса могут использоваться повторно между моделями, которые должны использовать заданный набор интерфейсов и элементов интерфейса. Словари данных хранятся в отдельных .sldd файлы.
адаптерАдаптер помогает соединить два компонента с несовместимыми интерфейсами портов путем сопоставления между этими двумя интерфейсами. Адаптер может также действовать как модуль задержка или переход скорости.

С помощью адаптера можно выполнить три функции в диалоговом окне Interface Adapter:

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

  • Применить преобразование интерфейса UnitDelay чтобы разбить алгебраический цикл.

  • Применить преобразование интерфейса RateTransition для согласования различных скоростей шага расчета для образцов модели.

Адаптер интерфейса

ТерминОпределениеПриложениеДополнительная информация
требованияНабор операторов, описывающих желаемое поведение и характеристики системы. Требования гарантируют целостность разработки системы и достижимы, поддаются проверке, однозначны и согласуются друг с другом. Каждый уровень проекта должен иметь соответствующие требования.Чтобы улучшить трассируемость требований, подсоедините систему, функциональные, пользовательские, производительные или проектные требования к компонентам и портам. Ссылка требований друг к другу для представления производных или присвоенных потребностей. Управление требованиями с точки зрения требований на модели архитектуры или через пользовательские представления. Присвойте тесты требованиям.

Введенный в R2019a