Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

Simulink.BusElement

指定总线元素的属性

说明

Simulink.BusElement 对象是验证总线中元素属性的 Simulink.Bus 对象的元素。仿真或更新模型时,Simulink® 检查 BusElement 对象指定的属性是否与对应总线元素指定的属性匹配。

BusElement 对象只存在于 Bus 对象中。您可以将 Bus 对象(但不能是 BusElement)指定为数据类型。

要在基础工作区或数据字典中创建和修改 BusBusElement 对象,您可以使用总线编辑器模型资源管理器或 MATLAB® 命令。您无法在模型工作区中存储 Bus 对象。

创建对象

您可以通过多种方式创建 BusElement 对象。

描述

示例

be = Simulink.BusElement 返回具有默认属性值的 BusElement 对象。

属性

全部展开

元素的名称,指定为字符向量。

注意

要根据 BusElement 对象验证信号的属性,信号名称必须是有效标识符,它以字母字符或下划线 (_) 开头并后跟字母数字字符或下划线。

数据类型: char | string

元素的数值类型,指定为 'real''complex'

数据类型: char | string

元素的维数,指定为标量或向量。

要在生成的代码中使用符号维度,请参阅 Implement Symbolic Dimensions for Array Sizes in Generated Code (Embedded Coder)

数据类型: double

元素的数据类型,指定为字符向量或字符串标量。

点击显示数据类型助手按钮 以显示数据类型助手,帮助您设置数据类型属性。有关详细信息,请参阅使用数据类型助手指定数据类型

您可以指定以下任一选项:

  • 内置 Simulink 数据类型 - 例如,指定 'single''uint8'。请参阅 Simulink 支持的数据类型

  • 定点数据类型 - 使用 fixdt 函数。例如,指定 'fixdt(1,16,0)'

  • 枚举数据类型 - 使用以 Enum: 开头的类型名称。例如,指定 'Enum: myEnumType'

  • 总线数据类型 - 使用以 Bus: 开头的 Simulink.Bus 对象的名称。例如,指定 'Bus: myBusObject'

  • 值类型 - 使用以 ValueType: 开头的 Simulink.ValueType 对象的名称。例如,指定 'ValueType: windVelocity'

  • 自定义数据类型 - 使用指定类型的 MATLAB 表达式。例如,您可以指定一个 Simulink.NumericType 对象,其 DataTypeMode 属性设置为 'Fixed-point: unspecified scaling' 以外的值。

通过指定 Simulink.Bus 对象,您可以创建指定分层总线(即包含其他总线的总线)的 Bus 对象。

当您指定 Simulink.ValueTypeSimulink.Bus 对象时,该对象不仅仅定义数据类型。该对象还定义诸如最小值最大值单位等属性。ValueType 对象指定的属性值会覆盖模块指定的对应属性值。例如,假设一个模块将单位设置为 ft/s。当该模块的数据类型指定以 m/s 为单位的 ValueType 对象时,该模块会使用 m/s 而不是 ft/s 作为单位。

数据类型: char | string

元素的最小值,指定为标量。此值必须是有限双精度实数标量;如果元素是总线,则该值必须为空,即 []

数据类型: double

元素的最大值,指定为标量。此值必须是有限双精度实数标量;如果元素是总线,则该值必须为空,即 []

数据类型: double

指定如何处理元素的大小,指定为 'Fixed''Variable'

数据类型: char | string

用于表示元素的物理单位,指定为字符向量。

有关详细信息,请参阅 Simulink 模型中的单位指定

示例: 'inches'

数据类型: char | string

总线元素描述,指定为字符向量。使用该描述来记录有关 BusElement 对象的信息,例如它应用到的信号种类。此信息不影响 Simulink 处理。

数据类型: char | string

示例

全部折叠

使用 Simulink.BusElement 对象的数组创建 Simulink.Bus 对象的层次结构。

在基础工作区中创建一个数组,其中包含两个 BusElement 对象,分别名为 ChirpSine

elems(1) = Simulink.BusElement;
elems(1).Name = 'Chirp';

elems(2) = Simulink.BusElement;
elems(2).Name = 'Sine';

数组索引允许您创建和访问数组的元素。圆点表示法允许您访问元素的属性值。

创建一个名为 SinusoidalBus 对象,该对象包含 elems 数组中定义的元素。

Sinusoidal = Simulink.Bus;
Sinusoidal.Elements = elems;

要创建 Bus 对象的层次结构,请创建另一个 Bus 对象来引用名为 SinusoidalBus 对象。

创建一个数组,其中包含两个 BusElement 对象,分别命名为 NestedBusStep。将名为 SinusoidalBus 对象指定为 NestedBus 元素的数据类型。

clear elems

elems(1) = Simulink.BusElement;
elems(1).Name = 'NestedBus';
elems(1).DataType = 'Bus: Sinusoidal';

elems(2) = Simulink.BusElement;
elems(2).Name = 'Step';

创建一个名为 TopBusBus 对象,该对象包含 elems 数组中定义的元素。

TopBus = Simulink.Bus;
TopBus.Elements = elems;

您可以在总线编辑器中查看创建的对象的层次结构。

buseditor

版本历史记录

在 R2006a 之前推出

全部展开