主要内容

addElement

添加元素

折叠所有页面

语法

元素= addElement(接口，名称)
element = addElement(接口，名称，名称，值)

描述

元素= addElement (接口，的名字）将元素添加到具有默认属性的接口中。

要从接口中删除元素，请使用removeElement函数。

例子

元素= addElement (接口，的名字，名称,值）使用名称-值参数设置元素的属性。

例子

全部折叠

创建一个新模型newModel．添加数据接口newInterface到模型的接口字典。然后，添加一个数据元素newElement数据类型双．

arch = systemcomposer.createModel(“newModel”,真正的);interface = addInterface(arch. interface)InterfaceDictionary,“newInterface”）;元素= addElement(接口，“newElement”数据类型=“替身”）
Interface: [1×1 systemcomposer. Interface . datainterface] Name: 'newElement' Type: [1×1 systemcomposer. Interface . datainterface]ValueType] UUID: '2d267175-33c2-43a9-be41-a1be2774a3cf' ExternalUID: "

创建一个名为“newModel”．添加物理接口“newInterface”到模型的接口字典。然后，添加一个物理元素“newElement”型“electrical.electrical”．修改物理域类型为“electrical.six_phase”．

arch = systemcomposer.createModel(“newModel”,真正的);interface = addPhysicalInterface(arch. interface)InterfaceDictionary,“newInterface”）;元素= addElement(接口，“newElement”，“类型”，“electrical.electrical”）;元素。类型=“electrical.six_phase”；元素
Name: 'newElement' Type: [1×1 systemcomposer.interface.PhysicalDomain] Interface: [1×1 systemcomposer.interface.PhysicalInterface] UUID: '32e4c51e-e567-42f1-b44a-2d2fcdbb5c25' ExternalUID: "

输入参数

全部折叠

接口，指定为systemcomposer.interface.DataInterface，systemcomposer.interface.PhysicalInterface,或systemcomposer.interface.ServiceInterface对象。

元素名称，指定为字符向量或字符串。元素名称必须是有效的MATLAB®变量的名字。

数据类型:字符|字符串

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:addElement(接口、“newElement”数据类型=“双”,维=“2”,单位=“米/秒”,复杂性=“复杂”,最小= " 0 ",最大= " 100 ",描述=“保持高度”)

数据类型，指定为有效MATLAB数据类型的字符向量或字符串。默认值为双．

例子:addElement(接口、“newElement”数据类型=“双”)

数据类型:字符|字符串

维度，指定为字符向量或字符串。默认值为1．

例子:addElement(接口、“newElement”维度=“2”)

数据类型:字符|字符串

单位，指定为字符向量或字符串。

例子:addElement(接口、“newElement”单位=“米/秒”)

数据类型:字符|字符串

复杂度，指定为字符向量或字符串。默认值为真正的．其他可能的值包括复杂的而且汽车．

例子:addElement(接口、“newElement”复杂性=“复杂的”)

数据类型:字符|字符串

最小值，指定为字符向量或字符串。

例子:addElement(接口、“newElement”最小= " 0 ")

数据类型:字符|字符串

最大值，指定为字符向量或字符串。

例子:addElement(接口、“newElement”最大= " 100 ")

数据类型:字符|字符串

描述，指定为字符向量或字符串。

例子:addElement(接口、“newElement”描述=“保持高度”)

数据类型:字符|字符串

物理元素的物理域，指定为部分物理域名的字符向量或字符串。有关有效物理域名的列表，请参见领域特定的行样式(Simscape)．

例子:addElement(接口、“newElement”类型=“electrical.six_phase”)

数据类型:字符|字符串

输出参数

全部折叠

元素返回systemcomposer.interface.DataElement，systemcomposer.interface.PhysicalElement,或systemcomposer.interface.FunctionElement对象。

更多关于

全部折叠

定义

术语 定义 应用程序 更多的信息
接口数据字典

一个接口数据字典是体系结构中所有接口和值类型及其使用位置的综合列表。

可以将System Composer™模型上的本地接口保存在接口数据字典中接口编辑器．您可以在需要使用一组给定的接口、元素和值类型的模型之间重用接口字典。链接数据字典存储在单独的SLDD文件中。
数据接口

一个数据接口定义流经端口的信息类型。同一个接口可以分配给多个端口。数据接口可以是复合的，这意味着它可以包括描述接口信号属性的数据元素。

数据接口表示通过连接器共享的信息，并通过端口进入或退出组件。使用接口编辑器创建和管理数据接口和数据元素，并将它们存储在接口数据字典中，以便在模型之间重用。
数据元素

一个数据元素描述接口的一部分，例如通信消息、计算或测量参数或该接口的其他分解。

数据接口被分解为数据元素:

  • 连接器或线束中的针或线

  • 通过总线传输的消息。

  • 组件间共享的数据结构。
值类型

一个值类型可以用作端口接口来定义流经该端口的原子数据块，并具有顶级类型、维度、单位、复杂性、最小值、最大值和描述。

还可以将数据接口中的数据元素类型指定为值类型。属性向数据字典中添加值类型接口编辑器这样您就可以重用值类型作为接口或数据元素。

 创建值类型作为接口
所有接口

一个所有接口是特定端口的本地接口，在数据字典或模型字典中不共享。

创建一个自有接口来表示端口本地的值类型或数据接口。

 定义属于端口的本地接口
适配器

一个适配器通过两个接口之间的映射，帮助连接端口不兼容的两个组件。适配器可以充当单位延迟或速率转换。您还可以使用适配器来创建总线。使用适配器块来实现适配器。

使用适配器，您可以在接口适配器对话框:

  • 创建和编辑输入和输出接口之间的映射。

  • 应用接口转换UnitDelay打破一个代数循环。

  • 应用接口转换RateTransition协调参考模型的不同采样时间率。

  • 当输出接口未定义时，您可以在总线创建模式下使用输入接口来创建拥有的输出接口。

版本历史

在R2019a中引入

另请参阅

||||||||

主题