Simulink.Bus.createObject
ブロックまたは MATLAB 構造体からの Simulink.Bus オブジェクトの作成
構文
説明
busInfo = Simulink.Bus.createObject(___,file,fileFormat)fileFormat が "object" の場合、Simulink.Bus オブジェクトの定義を配列を使用して保存します。"object" 形式を使用すると、関数が読みやすくなります。fileFormat の既定の設定は cell 配列を使用する "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
Out Bus Element ブロックで表されるバス要素端子から Simulink.Bus オブジェクトを作成します。
BusOutput という名前のモデル例を開きます。
mdl = "BusOutput";
open_system(mdl)
出力バスに複数レベルの階層があります。最上位のバスに入れ子にされたバスと信号が含まれています。入れ子にされたバスには 2 つの信号が含まれています。
OutBus という名前の出力端子のバス階層を定義する Simulink.Bus オブジェクトを作成して割り当てます。
プロパティ インスペクターを開くか、Out Bus Element ブロックをダブルクリックします。
OutBusを選択します。バスの属性が非表示になっている場合は、
をクリックします。[データ型] 属性の横にある
をクリックします。
あるいは、プログラムでバス オブジェクトを作成するには、Simulink.Bus.createObject 関数を使用します。
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" 形式がファイルで使用されます。たとえば、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);
この関数により 4 つの Simulink.Bus オブジェクトが作成されます。slBus1 という名前のオブジェクトは最上位の構造体に対応し、既定の名前を使用したものです。A、C、および C2 という名前のオブジェクトは、入れ子にされた構造体に対応します。
オブジェクトを表示するには、型エディターを開きます。
typeeditor
入力引数
出力引数
代替機能
プロパティ インスペクターまたは端子ダイアログ ボックスからバス要素端子の Simulink.Bus オブジェクトを作成して割り当てるには、バスを選択します。[データ型] パラメーターの横にある 
をクリックします。ソフトウェアによってモデルがコンパイルされ、サブシステム インターフェイスにおけるバス要素端子の最新のバス情報が取得されます。モデルでデータ ディクショナリが使用されている場合、データ ディクショナリ内にオブジェクトが作成されます。それ以外の場合、ベース ワークスペース内にオブジェクトが作成されます。 (R2026a 以降)
