exponenta event banner

systemcomposer.importModel

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

Описание

пример

archModel = systemcomposer.importModel(modelName,components,ports,connections,portInterfaces,requirementLinks) создает новую архитектурную модель на основе таблиц MATLAB ®, в которых указываются компоненты, порты, соединения, интерфейсы портов и связи требований. Единственными обязательными входными аргументами являютсяmodelName и components таблица. Для пустых аргументов ввода таблицы введите table.emptyоднако конечные пустые таблицы игнорируются и вводить их не требуется. Сведения об импорте модели базовой архитектуры см. в разделе Определение базовой архитектуры. Для импорта 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. components таблица должна содержать имя, уникальный идентификатор и идентификатор родительского компонента для каждого компонента. Он также может включать другую релевантную информацию, необходимую для построения иерархии архитектуры для ссылочной модели, и имена квалификаторов стереотипа. ports таблица должна содержать имя порта, направление, компонент и информацию об идентификаторе порта. Информация интерфейса порта может также потребоваться для назначения портов компонентам. connections таблица содержит информацию для подключения портов. Как минимум, эта таблица должна содержать идентификатор соединения, идентификатор порта источника и идентификатор порта назначения.

API systemcomposer.importModel (importModelName):

  • Считывает имена стереотипов из 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см. раздел Импорт компонентов исполнения, Поведение потока состояний или Ссылочные компоненты. Применение стереотипов с помощью 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. Сведения об импорте интерфейсов и сопоставлении портов с интерфейсами см. в разделе Импорт интерфейсов и сопоставление портов с интерфейсами. Назначение стереотипа с помощью дополнительного столбца StereotypeNames.

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

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

Типы данных: 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 файлы.

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

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

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

  • Порты архитектуры - это порты на границе системы, независимо от того, находится ли граница в пределах компонента или общей модели архитектуры.

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

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

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

  • Контакты или провода в соединителе или электрическом жгуте.

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

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

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

С помощью адаптера можно выполнять три функции в диалоговом окне «Адаптер интерфейса»:

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

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

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

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

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

Представлен в R2019a