プログラムによるバスオブジェクトの作成

Simulink.Bus オブジェクトとその Simulink.BusElement オブジェクトを、配列、ブロック、cell 配列、構造体、または C コードからプログラムで作成できます。

Bus オブジェクトをプログラムで作成するときに、それらを MATLAB^® ワークスペースまたはデータディクショナリに格納することも、その定義を関数内に保存することもできます。ベースワークスペースの Bus オブジェクトについて、関数 Simulink.Bus.save を使用して、プログラムでその定義を関数内に保存できます。

Bus オブジェクトを使用するブロックのシミュレーションを実行するには、その Bus オブジェクトがベースワークスペースまたはデータディクショナリ内になければなりません。

配列からの Bus オブジェクトの作成

ライブスクリプトを開く

配列を使用して Bus オブジェクトの階層を作成します。配列のインデックス付けにより、配列内の複数の要素を作成したり要素にアクセスしたりできます。ドット表記によってプロパティ値にアクセスできます。

Chirp および Sine という名前の 2 つの BusElement オブジェクトをベースワークスペースに作成します。

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

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

elems 配列で定義される要素を使用する、NestedBus という名前の Bus オブジェクトを作成します。

NestedBus = Simulink.Bus;
NestedBus.Elements = elems;

NestedBus および Step という名前の、さらに 2 つの BusElement オブジェクトを作成します。NestedBus が Bus オブジェクトを表すようにするには、Bus オブジェクトのデータ型を指定します。

clear elems

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

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

elems 配列で定義される要素を使用するバスの階層の最上位でバスを作成します。

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

作成されたオブジェクトを [バスエディター] で表示できます。

buseditor

ブロックからのバスオブジェクトの作成

モデル内のブロックに基づいて Bus オブジェクトをプログラムで作成するには、関数 Simulink.Bus.createObject を使用します。

バス階層の最上位にある Bus Creator ブロックを指定すると、関数によって、入れ子になったバスを含め、階層内のすべてのバスについて Bus オブジェクトが作成されます。

MATLAB データからのバスオブジェクトの作成

cell 配列から Bus オブジェクトを作成するには、関数 Simulink.Bus.cellToObject を使用します。後続のそれぞれの cell 配列は Bus オブジェクトを表しています。

MATLAB 構造体から Bus オブジェクトを作成するには、関数 Simulink.Bus.createObject を使用します。構造体には MATLAB timeseries オブジェクト、MATLAB timetable オブジェクト、および matlab.io.datastore.SimulationDatastore オブジェクトが含まれていてもよいですし、または数値構造体であってもかまいません。

外部 C コードからのバスオブジェクトの作成

既存の C コードで定義した構造体型 (struct) に一致する Bus オブジェクトを作成できます。その後、シミュレーション用に既存のアルゴリズム C コードを統合する準備 (レガシコードツールを使用するなど) のため、Bus オブジェクトを使用して、構造型に従って信号またはパラメーターデータをパッケージ化できます。オブジェクトを作成するには、関数 Simulink.importExternalCTypes を使用します。