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

Simulink.BusElement

指定总线元素的属性

全页展开

说明

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

您可以指定总线对象作为数据类型，但不能指定总线元素对象作为数据类型。

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

创建对象

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

语法

be = Simulink.BusElement

描述

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

示例

属性

全部展开

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

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

数据类型: char | string

元素的数值类型，指定为 'real' 或 'complex'。

依赖关系

当 DataType 指定 Simulink.ValueType 或 Simulink.Bus 对象时，软件将忽略此属性的值。软件改用 Simulink.ValueType 对象或 Simulink.Bus 对象中的 Simulink.BusElement 对象指定的复/实性。

数据类型: char | string

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

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

依赖关系

当 DataType 指定 Simulink.ValueType 对象时，软件会忽略此属性的值。软件改用 Simulink.ValueType 对象指定的维度。

数据类型: double

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

数据类型助手可帮助您设置数据属性。要使用数据类型助手，请点击 the Show data type assistant button。有关详细信息，请参阅使用数据类型助手指定数据类型。

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

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

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

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

  • 总线数据类型 - 使用 Simulink.Bus 对象的名称（可以选择以 Bus: 开头）。例如，指定 'myBusObject' 或 'Bus: myBusObject'。

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

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

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

当您指定 Simulink.ValueType 或 Simulink.Bus 对象作为数据类型时，将忽略 Simulink.BusElement 对象的某些属性。例如，忽略 Simulink.BusElement 对象的 Min、Max 和 Unit 属性。软件改用 Simulink.ValueType 对象或 Simulink.Bus 对象中 Simulink.BusElement 对象的对应属性。

数据类型: char | string

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

依赖关系

当 DataType 指定 Simulink.ValueType 或 Simulink.Bus 对象时，软件将忽略此属性的值。软件改用 Simulink.ValueType 对象或 Simulink.Bus 对象中的 Simulink.BusElement 对象指定的最小值。

数据类型: double

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

依赖关系

当 DataType 指定 Simulink.ValueType 或 Simulink.Bus 对象时，软件将忽略此属性的值。软件改用 Simulink.ValueType 对象或 Simulink.Bus 对象中的 Simulink.BusElement 对象指定的最大值。

数据类型: double

指定如何处理元素的大小，指定为 'Fixed' 或 'Variable'。

依赖关系

当 DataType 指定 Simulink.ValueType 或 Simulink.Bus 对象时，软件将忽略此属性的值。软件改用 Simulink.ValueType 对象或 Simulink.Bus 对象中的 Simulink.BusElement 对象指定的维度模式。

数据类型: char | string

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

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

示例: 'inches'

依赖关系

当 DataType 指定 Simulink.ValueType 或 Simulink.Bus 对象时，软件将忽略此属性的值。软件改用 Simulink.ValueType 对象或 Simulink.Bus 对象中的 Simulink.BusElement 对象指定的单位。

数据类型: char | string

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

数据类型: char | string

示例

全部折叠

打开实时脚本

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

在基础工作区中创建一个数组，其中包含两个 BusElement 对象，分别名为 Chirp 和 Sine。

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

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

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

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

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

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

创建一个数组，其中包含两个 BusElement 对象，分别命名为 NestedBus 和 Step。将名为 Sinusoidal 的 Bus 对象指定为 NestedBus 元素的数据类型。

clear elems

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

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

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

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

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

typeeditor

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

|

主题