Simulink.Bus.createObject
从模块或 MATLAB 结构体创建 Simulink.Bus 对象
语法
说明
busInfo = Simulink.Bus.createObject(___,file,fileFormat)fileFormat 是 "object"）使用数组保存 Simulink.Bus 对象定义。"object" 格式使函数更易于读取。fileFormat 的默认值为 "cell"，它使用元胞数组并且更加紧凑。
busInfo = Simulink.Bus.createObject(S,file,fileFormat,scope)scope 指定的数据字典中创建 Simulink.Bus 对象。
示例
基于 Bus Creator 模块创建 Simulink.Bus 对象，该模块创建一个具有多级层次结构的总线。
打开名为 BusHierarchy 的示例模型。
mdl = "BusHierarchy";
open_system(mdl)
基于名为 Bus Creator1 的 Bus Creator 模块创建一个 Simulink.Bus 对象。此模块接收来自源模块和另一个 Bus Creator 模块的输入。
block = "BusHierarchy/Bus Creator1";
busInfo = Simulink.Bus.createObject(mdl,block);此命令在基础工作区中创建名为 TopBus 和 NestedBus 的 Simulink.Bus 对象。每个总线对象表示总线层次结构中的一个总线。
要查看 Simulink.Bus 对象，请打开类型编辑器。
typeeditor
基于总线元素端口创建 Simulink.Bus 对象，这些对象由 Out Bus Element 模块表示。
打开名为 BusOutput 的示例模型。
mdl = "BusOutput";
open_system(mdl)
输出总线有多级层次结构。顶层总线包含一个嵌套总线。
创建 Simulink.Bus 对象，这些对象在名为 OutBus 的输出端口上定义总线层次结构。
port = "BusOutput/OutBus";
busInfo = Simulink.Bus.createObject(mdl,port);要查看这些对象，请打开类型编辑器。
typeeditor
基于 Bus Creator 模块创建 Simulink.Bus 对象，并将 Simulink.Bus 对象定义保存在一个函数中。
打开名为 BusHierarchy 的示例模型。
mdl = "BusHierarchy";
open_system(mdl);
基于名为 Bus Creator1 的 Bus Creator 模块创建 Simulink.Bus 对象。此模块接收来自源模块和另一个 Bus Creator 模块的输入。要在函数中保存 Simulink.Bus 对象定义，还需指定文件名。
block = "BusHierarchy/Bus Creator1"; file = "BusObjectFunction"; busInfo = Simulink.Bus.createObject(mdl,block,file);
这些命令在基础工作区中创建名为 TopBus 和 NestedBus 的 Simulink.Bus 对象，并在当前文件夹中创建名为 BusObjectFunction 的文件。
要检查文件内容，请打开文件。默认情况下，该文件使用 "cell" 格式。例如，Chirp 元素是由一个元胞数组定义的。
{'Chirp', 1, 'double', 'real', 'Sample', 'Fixed', [], [], '', ''};
对于采用更易于读取的格式的文件，请将文件格式指定为 "object"。
file1 = "BusObjectFunctionFormatted"; busInfo1 = Simulink.Bus.createObject(mdl,block,file1,"object");
要检查文件内容，请打开文件。在 "object" 格式中，Chirp 元素由数组定义，该数组使用圆点表示法对属性赋值。
elems(1) = Simulink.BusElement; elems(1).Name = 'Chirp'; elems(1).Dimensions = 1; elems(1).DimensionsMode = 'Fixed'; elems(1).DataType = 'double'; elems(1).Complexity = 'real'; elems(1).Min = []; elems(1).Max = []; elems(1).DocUnits = ''; elems(1).Description = '';
当您使用 Constant 模块创建非虚拟总线时，您必须为常量值指定一个 MATLAB 结构体，并将 Simulink.Bus 对象指定为输出数据类型。
对于此示例，创建一个包含其他结构体的结构体。
bus_struct.A.A1 = 0; bus_struct.A.A2 = [0 + 0i;0 + 0i;0 + 0i;0 + 0i;0 + 0i]; bus_struct.B = 5; bus_struct.C.C1 = 0; bus_struct.C.C2.A1 = 0; bus_struct.C.C2.A2 = [0 + 0i;0 + 0i;0 + 0i;0 + 0i;0 + 0i];
创建与该结构体对应的 Simulink.Bus 对象。
busInfo = Simulink.Bus.createObject(bus_struct);
该函数创建四个 Simulink.Bus 对象。名为 slBus1 的对象对应于顶层结构体，并使用默认名称。名为 A、C 和 C2 的对象对应于嵌套结构体。
要查看这些对象，请打开类型编辑器。
typeeditor
