主要内容

本页采用了机器翻译。点击此处可查看英文原文。

addElement

添加元素

说明

element = addElement(interface,name) 将一个元素添加到具有默认属性的接口中。

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

element = addElement(interface,name,Name=Value) 使用名称-值参量设置元素的属性。

示例

示例

全部折叠

创建新模型 newModel。在模型的字典中添加数据接口 newInterface。然后,添加一个数据类型为 newElement 的数据元素 double

arch = systemcomposer.createModel("newModel");
interface = addInterface(arch.InterfaceDictionary,"newInterface");
element = addElement(interface,"newElement",DataType="double")
element = 

  DataElement with properties:

      Interface: [1×1 systemcomposer.interface.DataInterface]
           Name: 'newElement'
           Type: [1×1 systemcomposer.ValueType]
           UUID: '2d267175-33c2-43a9-be41-a1be2774a3cf'
    ExternalUID: ''

创建一个名为 'newModel' 的新模型。在模型字典中添加物理接口 'newInterface'。然后,添加一个类型为 'newElement' 的物理元素 'electrical.electrical'。将物理域类型更改为 'electrical.six_phase'

arch = systemcomposer.createModel('newModel');
interface = addPhysicalInterface(arch.InterfaceDictionary,'newInterface');
element = addElement(interface,'newElement','Type','electrical.electrical');
element.Type = 'electrical.six_phase';
element
element = 

  PhysicalElement with properties:

           Name: 'newElement'
           Type: [1×1 systemcomposer.interface.PhysicalDomain]
      Interface: [1×1 systemcomposer.interface.PhysicalInterface]
           UUID: '32e4c51e-e567-42f1-b44a-2d2fcdbb5c25'
    ExternalUID: ''

输入参数

全部折叠

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

数据类型: char | string

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来

示例: addElement(interface,"newElement",DataType="double",Dimensions="2",Units="m/s",Complexity="complex",Minimum="0",Maximum="100",Description="Maintain altitude")

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

示例: addElement(interface,"newElement",DataType="double")

数据类型: char | string

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

示例: addElement(interface,"newElement",Dimensions="2")

数据类型: char | string

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

示例: addElement(interface,"newElement",Units="m/s")

数据类型: char | string

复杂度,指定为字符向量或字符串。默认值为 real。其他可能的值有 complexauto

示例: addElement(interface,"newElement",Complexity="complex")

数据类型: char | string

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

示例: addElement(interface,"newElement",Minimum="0")

数据类型: char | string

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

示例: addElement(interface,"newElement",Maximum="100")

数据类型: char | string

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

示例: addElement(interface,"newElement",Description="Maintain altitude")

数据类型: char | string

物理元素的物理域,指定为字符向量或部分物理域名字符串。有关有效物理域名的列表,请参阅域特定线型 (Simscape)

示例: addElement(interface,"newElement",Type="electrical.six_phase")

数据类型: char | string

输出参量

全部折叠

详细信息

全部折叠

版本历史记录

在 R2019a 中推出

另请参阅

函数

对象

模块

工具