Main Content

systemcomposer.analysis.loadInstance

Load architecture instance

Description

example

instance = systemcomposer.analysis.loadInstance(fileName,overwrite) loads an architecture instance from a MAT-file.

This function is part of the instance API that you can use to analyze the model iteratively, element by element. instance refers to the element instance on which the iteration is being performed.

Examples

collapse all

Create a profile for latency characteristics.

profile = systemcomposer.profile.Profile.createProfile('LatencyProfile');

latencybase = profile.addStereotype('LatencyBase');
latencybase.addProperty('latency','Type','double');
latencybase.addProperty('dataRate','Type','double','DefaultValue','10');

connLatency = profile.addStereotype('ConnectorLatency','Parent',...
'LatencyProfile.LatencyBase');
connLatency.addProperty('secure','Type','boolean');
connLatency.addProperty('linkDistance','Type','double');

nodeLatency = profile.addStereotype('NodeLatency','Parent',...
'LatencyProfile.LatencyBase');
nodeLatency.addProperty('resources','Type','double','DefaultValue','1');

portLatency = profile.addStereotype('PortLatency','Parent',...
'LatencyProfile.LatencyBase');
portLatency.addProperty('queueDepth','Type','double');
portLatency.addProperty('dummy','Type','int32');

Instantiate all stereotypes in a profile.

model = systemcomposer.createModel('archModel',true);
instance = instantiate(model.Architecture,'LatencyProfile','NewInstance');

Save the architecture instance.

instance.save('InstanceFile');

Delete the architecture instance.

systemcomposer.analysis.deleteInstance(instance);

Load the architecture instance.

loadedInstance = systemcomposer.analysis.loadInstance('InstanceFile');

Input Arguments

collapse all

MAT-file that contains architecture instance, specified as a character vector.

Data Types: char

Whether to overwrite instance if it already exists in workspace, specified as a logical 1 (true) so the load operation overwrites duplicate instances in the workspace or 0 (false) if not.

Output Arguments

collapse all

Loaded architecture instance, returned as a systemcomposer.analysis.ArchitectureInstance object.

More About

collapse all

Definitions

TermDefinitionApplicationMore Information
analysisAnalysis is a method for quantitatively evaluating an architecture for certain characteristics. Static analysis analyzes the structure of the system. Static analysis uses an analysis function and parametric values of properties captured in the system model.Use analysis to calculate overall reliability, mass roll-up, performance, or thermal characteristics of a system, or to perform a SWaP analysis.Analyze Architecture
instanceAn instance is an occurrence of an architecture model at a given point of time.You can update an instance with changes to a model, but the instance will not update with changes in active variants or model references. You can use an instance, saved in an .MAT file, of a System Composer™ architecture model for analysis.Create a Model Instance for Analysis

Introduced in R2019a