Класс, который представляет элемент модели в аналитическом экземпляре
Instance класс представляет экземпляр элемента модели.
Связанные классы включают:
Создайте экземпляр архитектуры.
instance = instantiate(model.Architecture,'LatencyProfile','NewInstance', ... 'Function',@calculateLatency,'Arguments','3','Strict',true, ... 'NormalizeUnits',false,'Direction','PreOrder')
getValue | Получите значение свойства от экземпляра элемента |
setValue | Установите значение свойства для экземпляра элемента |
hasValue | Найдите, имеет ли экземпляр элемента значение свойства |
isArchitecture | Найдите, является ли экземпляр экземпляром архитектуры |
isComponent | Найдите, является ли экземпляр экземпляром компонента |
isConnector | Найдите, является ли экземпляр экземпляром коннектора |
isPort | Найдите, является ли экземпляр экземпляром порта |
Этот пример показывает инстанцирование для анализа для системы с задержкой в ее проводном соединении. Используемые материалы являются медью, волокном и WiFi.
Создайте профиль задержки со стереотипами и свойствами
Создайте профиль System Composer с основой, коннектором, компонентом и стереотипом порта. Добавьте свойства со значениями по умолчанию к каждому стереотипу по мере необходимости для анализа.
profile = systemcomposer.profile.Profile.createProfile('LatencyProfile'); % Add base stereotype with properties latencybase = profile.addStereotype('LatencyBase'); latencybase.addProperty('latency','Type','double'); latencybase.addProperty('dataRate','Type','double','DefaultValue','10'); % Add connector stereotype with properties connLatency = profile.addStereotype('ConnectorLatency','Parent',... 'LatencyProfile.LatencyBase'); connLatency.addProperty('secure','Type','boolean','DefaultValue','true'); connLatency.addProperty('linkDistance','Type','double'); % Add component stereotype with properties nodeLatency = profile.addStereotype('NodeLatency','Parent',... 'LatencyProfile.LatencyBase'); nodeLatency.addProperty('resources','Type','double','DefaultValue','1'); % Add port stereotype with properties portLatency = profile.addStereotype('PortLatency','Parent',... 'LatencyProfile.LatencyBase'); portLatency.addProperty('queueDepth','Type','double','DefaultValue','4.29'); portLatency.addProperty('dummy','Type','int32');
Инстанцируйте Используя аналитическую функцию
Создайте новую модель и примените профиль. Создайте компоненты, порты и связи в модели. Примените стереотипы к элементам модели. Наконец, инстанцируйте использования аналитической функции.
model = systemcomposer.createModel('archModel',true); % Create new model arch = model.Architecture; model.applyProfile('LatencyProfile'); % Apply profile to model % Create components, ports, and connections components = addComponent(arch,{'Sensor','Planning','Motion'}); sensorPorts = addPort(components(1).Architecture,{'MotionData','SensorData'},{'in','out'}); planningPorts = addPort(components(2).Architecture,{'SensorData','MotionCommand'},{'in','out'}); motionPorts = addPort(components(3).Architecture,{'MotionCommand','MotionData'},{'in','out'}); c_sensorData = connect(arch,components(1),components(2)); c_motionData = connect(arch,components(3),components(1)); c_motionCommand = connect(arch,components(2),components(3)); % Clean up canvas Simulink.BlockDiagram.arrangeSystem('archModel'); % Batch apply stereotypes to model elements batchApplyStereotype(arch,'Component','LatencyProfile.NodeLatency'); batchApplyStereotype(arch,'Port','LatencyProfile.PortLatency'); batchApplyStereotype(arch,'Connector','LatencyProfile.ConnectorLatency'); % Instantiate using the analysis function instance = instantiate(model.Architecture,'LatencyProfile','NewInstance', ... 'Function',@calculateLatency,'Arguments','3','Strict',true, ... 'NormalizeUnits',false,'Direction','PreOrder')
instance =
ArchitectureInstance with properties:
Specification: [1x1 systemcomposer.arch.Architecture]
IsStrict: 1
NormalizeUnits: 0
AnalysisFunction: @calculateLatency
AnalysisDirection: PreOrder
AnalysisArguments: '3'
ImmediateUpdate: 0
Components: [1x3 systemcomposer.analysis.ComponentInstance]
Ports: [0x0 systemcomposer.analysis.PortInstance]
Connectors: [1x3 systemcomposer.analysis.ConnectorInstance]
Name: 'NewInstance'
Смотрите компонент, порт и экземпляры коннектора
Получите свойства от компонента, порта и экземпляров коннектора.
defaultResources = instance.Components(1).getValue('LatencyProfile.NodeLatency.resources')defaultResources = 1
defaultSecure = instance.Connectors(1).getValue('LatencyProfile.ConnectorLatency.secure')defaultSecure = logical
1
defaultQueueDepth = instance.Components(1).Ports(1).getValue('LatencyProfile.PortLatency.queueDepth')defaultQueueDepth = 4.2900
Очистка
Не прокомментируйте следующий код и запуск, чтобы очистить артефакты, созданные этим примером:
% bdclose('archModel') % systemcomposer.profile.Profile.closeAll
Обзор
В этом примере показано, как смоделировать типичную автомобильную электрическую систему как архитектурную модель и запустить примитивный анализ. Элементы в модели могут быть широко сгруппированы или как источник или как загрузка. Различные свойства источников и загрузок установлены как часть стереотипа. Пример использует iterate метод API спецификации, чтобы выполнить итерации через каждый элемент модели и анализа запуска с помощью стереотипных свойств.
Структура модели
Генератор заряжает батарею, в то время как механизм запускается. Батарея, наряду с генератором поддерживает электрические нагрузки в транспортном средстве, как ECU, радио и управление телом. Индуктивные нагрузки как двигатели и другие обмотки имеют InRushCurrent стереотипируйте заданное свойство. На основе набора свойств на каждом компоненте выполняются следующие исследования:
Общий KeyOffLoad.
Номер дней требуется для KeyOffLoad разряжать 30% батареи.
Общий CrankingInRush текущий.
Общий Cranking текущий.
Способность батареи запустить транспортное средство в 0°F на основе холодных усилителей проворота (CCA) батареи. Время выброса вычисляется на основе коэффициента Puekert (k), который описывает отношение между уровнем выброса и полезной мощностью батареи.
Загрузите модель и запустите анализ
archModel = systemcomposer.openModel('scExampleAutomotiveElectricalSystemAnalysis'); % Instantiate battery sizing class used by the analysis function to store % analysis results. objcomputeBatterySizing = computeBatterySizing; % Run the analysis using the iterator. archModel.iterate('Topdown',@computeLoad,objcomputeBatterySizing); % Display analysis results. objcomputeBatterySizing.displayResults;
Total KeyOffLoad: 158.708 mA Number of days required for KeyOffLoad to discharge 30% of battery: 55.789. Total CrankingInRush current: 70 A Total Cranking current: 104 A CCA of the specifed battery is sufficient to start the car at 0 F.
Закройте модель
bdclose('scExampleAutomotiveElectricalSystemAnalysis');deleteInstance | instantiate | iterate | loadInstance | refresh | save | systemcomposer.analysis.ArchitectureInstance | systemcomposer.analysis.ComponentInstance | systemcomposer.analysis.ConnectorInstance | systemcomposer.analysis.PortInstance | update