使用导入系统编写器体系结构`ModelBuilder`

打开实时脚本

将体系结构规范导入到System Composer™中systemcomposer.io.ModelBuilder实用程序类。这些体系结构规范可以在外部源文件中定义，例如Excel®文件。

在System Composer中，架构是由四组信息完全定义的:

组件及其在体系结构层次结构中的位置。
端口及其到组件的映射。
组件之间通过端口连接。在本例中，我们还从外部源导入接口数据定义。
体系结构模型中的接口及其到端口的映射。

此示例使用systemcomposer.io.ModelBuilder类来传递上述所有体系结构信息并导入System Composer模型。

在本例中，在Excel电子表格中定义了小型无人机系统的体系结构信息，并用于创建system Composer体系结构模型。

外部源文件

Architecture.xlsx—该Excel文件包含架构模型的层次信息。这个示例将外部源数据映射到System Composer模型元素。该信息在列名中映射到System Composer模型元素。

#元素:元素名。可以是组件名或端口名。# Parent:父元素名。#类:可以是组件或端口(端口的输入/输出方向)。#域:映射为组件属性。在Stereotype PartDescriptor下的概要文件UAVComponent中定义的属性“Manufacturer”映射到excel源文件中的域值。#类型:映射为组件属性。在Stereotype PartDescriptor下的UAVComponent配置文件中定义的属性“ModelName”映射到excel源文件中的Kind值。如果class是端口类型。InterfaceName对应与端口相连的接口名称。 # ConnectedTo : In case of port type, it specifies the connection to other port defined in format "ComponentName::PortName".

DataDefinitions.xlsx-此Excel文件包含模型的接口数据定义。本示例假设Excel源文件中的数据定义与System Composer中的接口层次结构之间存在这种映射。

# Name:接口或元素的名称。# Parent:父接口名称(仅适用于元素)。# Datatype:元素的数据类型。可以是另一个接口，格式为Bus: InterfaceName # Dimensions:元素的尺寸。# Units:元素的单位属性。# Minimum:元素的最小值。# Maximum:元素的最大值。

步骤1。实例化`ModelBuilder`类

实例化ModelBuilder使用配置文件名称初始化。

[stat,fa] = fileattrib(pwd);如果~足总。使用rWrite disp('此脚本必须在可写目录中运行'）;返回；结束

指定要构建的模型的名称。

modelName =“scExampleModelBuider”；

指定配置文件的名称。

形象=“UAVComponent”；

指定要读取体系结构信息的源文件的名称。

architectureFileName =“Architecture.xlsx”；

实例化ModelBuilder．

builder = systemcomposer.io.ModelBuilder(配置文件);

步骤2。构建接口数据定义

读取外部源文件中的信息DataDefinitions.xlsx建立接口数据模型。

从Excel源文件创建MATLAB®表。

opts = detectImportOptions(“DataDefinitions.xlsx”）;选择。DataRange =“A2”；

力readtable从第二行开始读。

definitionContents =可读的(“DataDefinitions.xlsx”、选择);

的systemcomposer.io.IdService类生成唯一的ID对于一个给定的键。

idService = systemcomposer.io.IdService();为rowItr =1:numel(definitionContents(:，1)) parentInterface = definitionContents. parent {rowItr};如果isempty (parentInterface)

对于接口，将接口名称添加到模型构建器中。

interfaceName = definitionContents.Name{rowItr};

获得独特的界面ID．

getID(容器,键)为容器内的输入键生成或返回(如果键已经存在)相同的值。

interfaceID = idService.getID(“接口”, interfaceName);

使用builder.addInterface将接口添加到数据字典。

builder.addInterface (interfaceName interfaceID);其他的

对于元素，读取元素属性并将元素添加到父接口。

elementName = definitionContents.Name{rowItr};interfaceID = idService.getID(“接口”, parentInterface);

的ElementID在一个接口中是唯一的。附加E在开始的时候ID均匀性。生成的ID输入元素在父接口名称中作为容器是唯一的。

elementid = idService.getID(parentInterface,elementName，“E”）;

设置元素的数据类型、尺寸、单位、最小和最大属性。

datatype = definitionContents.DataType{rowItr};dimensions = string(definitionContents.Dimensions(rowItr));units = definitionContents.Units(rowItr);

确保生成器效用函数的输入总是一个字符串。

如果~ischar(units) units =”；结束minimum = definitionContents.Minimum{rowItr};maximum = definitionContents.Maximum{rowItr};

使用builder.addElementInInterface在接口中添加具有属性的元素。

builder.addElementInInterface (elementName elemID interfaceID,数据类型,尺寸,单位,“真实”的、最大、最小);结束结束

步骤3。构建体系结构规范

体系结构规范是由MATLAB表从Excel源文件创建的。

excelContents = readtable(architectureFileName);

遍历表中的每一行。

为rowItr = 1:元素个数(excelContents (: 1))

读取Excel文件的每一行和每列。

class = excelContents.Class(rowItr);Parent = excelContents.Parent(rowItr);名称= excelContents.Element{rowItr};

填充表的内容。

如果比较字符串(类,“组件”ID = idService.getID(“薪酬”、名称);

的根ID默认设置为零。

如果比较字符串(父,“scExampleSmallUAV”) parentID =“0”；其他的parentID = idService.getID(“薪酬”、家长);结束

使用builder.addComponent添加组件。

builder.addComponent(名称、ID parentID);

读取属性值。

kind = excelContents.Kind{rowItr};domain = excelContents.Domain{rowItr};

使用builder.setComponentProperty来设置原型和属性值。

builder.setComponentProperty (ID、“StereotypeName”，“UAVComponent。PartDescriptor”，“ModelName”、善良、“制造商”域);其他的

在本例中，端口名称和父组件名称的连接被用作为端口生成惟一id的键。

portID = idService.getID(“端口”strcat(名称、父));

对于根架构上的端口，列表假设为0．

如果比较字符串(父,“scExampleSmallUAV”) compID =“0”；其他的compID = idService.getID(“薪酬”、家长);结束

使用builder.addPort添加端口。

builder.addPort(Name,class,portID,compID );

的InterfaceName指定与该端口相连的接口名称。

interfaceName = excelContents.InterfaceName{rowItr};

获取接口ID。

getID将返回在步骤2中添加接口时已经生成的相同id。

interfaceID = idService.getID(“接口”, interfaceName);

使用builder.addInterfaceToPort将接口映射到端口。

builder.addInterfaceToPort (interfaceID portID);

读了与用于在组件之间建立连接的信息。

connectedTo = excelContents.ConnectedTo{rowItr};

与的格式为:

(DestinationComponentName:: DestinationPortName)

对于本例，将当前端口视为连接源。

如果~isempty(connectedTo) connID = idService.getID(“连接”,与);分裂=分裂(connectedTo，“::”）;

获取连接端口的端口号。

本例中，端口ID由端口名称和父组件名称拼接而成。如果端口号已经生成，则getID函数为输入键返回相同的ID。

connectedPortID = idService.getID(“端口”strcat(分裂(2)将(1)));

填充连接表。

sourcePortID = portID;destPortID = connectedPortID;

使用builder.addConnection添加连接。

builder.addConnection(与、connID sourcePortID destPortID);结束结束结束

步骤3。从已填充的表导入模型`builder.build`函数

[model,importReport] = builder.build(modelName);

另请参阅

systemcomposer.io.ModelBuilder|importModel|exportModel

使用导入系统编写器体系结构ModelBuilder