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

最新のリリースでは、このページがまだ翻訳されていません。このページの最新版は英語でご覧になれます。

ブロック、データ、または C コードに基づいてバスオブジェクトとその要素をプログラムで新規に作成します。

Simulink.Bus オブジェクトおよび Simulink.BusElement オブジェクトの直接作成— Simulink.Bus オブジェクトを作成し、そのプロパティを定義する。バスの要素に対して Simulink.BusElement オブジェクトを作成します。
ブロックからのバスオブジェクトの作成— モデルのブロックに基づいてバスオブジェクトとそのバス要素オブジェクトを作成する。
MATLAB データからのバスオブジェクトの作成— MATLAB^® 構造体または cell 配列に基づいてバスオブジェクトとそのバス要素を作成する。
外部 C コードからのバスオブジェクトの作成— 外部の C コード (struct) に基づいてバスオブジェクトとそのバス要素を作成する。関数 Simulink.importExternalCTypes を使用します。

バスオブジェクトをプログラムにより作成したので、それらを MATLAB ワークスペースまたは MATLAB ファイルに格納できます。バスオブジェクトを作成した後 MATLAB コマンドを使用してバスオブジェクトを MAT ファイルに保存できます (ワークスペース変数の保存と読み込み (MATLAB)を参照)。バスオブジェクトを使用するブロックのシミュレーションを実行するには、バスオブジェクトがベースワークスペースまたはデータディクショナリ内になければなりません。

バスオブジェクトの定義前または定義後のいずれかに、ブロックのデータ型にするバスオブジェクトを指定できます。ただし、モデルをシミュレートする前に、バスオブジェクトと対応するバス信号に、同じ数のバス要素が同じ順序で含まれていなければなりません。また、バスオブジェクトおよび対応するバス要素信号内の各バス要素が同じデータ型と次元をもたなければなりません。

モデルの開発中に、バス信号を変更してバスオブジェクトと一致させるか、バスオブジェクトを変更してバスと一致させることができます。

Simulink.Bus オブジェクトおよび Simulink.BusElement オブジェクトの直接作成

Simulink.Bus オブジェクトとその Simulink.BusElement オブジェクトをプログラムにより作成することができます。バスオブジェクトはベースワークスペースに格納されます。各バス要素オブジェクトについて、名前、次元およびデータ型を指定します。バス要素オブジェクトの他のプロパティはオプションです。バスオブジェクトの場合は、バス要素を指定します。バスオブジェクトの他のプロパティはオプションです。たとえば、次のコードでは CONTROL バスオブジェクトの要素として使用される 2 つのバス要素オブジェクトが作成されます。

clear elems;
elems(1) = Simulink.BusElement;
elems(1).Name = 'VALVE1';
elems(1).Dimensions = 1;
elems(1).DimensionsMode = 'Fixed';
elems(1).DataType = 'double';
elems(1).SampleTime = -1;
elems(1).Complexity = 'real';

elems(2) = Simulink.BusElement;
elems(2).Name = 'VALVE2';
elems(2).Dimensions = 1;
elems(2).DimensionsMode = 'Fixed';
elems(2).DataType = 'double';
elems(2).SampleTime = -1;
elems(2).Complexity = 'real';

CONTROL = Simulink.Bus;
CONTROL.Elements = elems;

このスクリプトは、バスオブジェクトを MATLAB ファイルに保存して、[オブジェクト] 形式を選択した場合のファイルと似ています。バスオブジェクトの保存の詳細については、バスオブジェクトの保存を参照してください。

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

モデルのブロックに基づいて、バスオブジェクトとそのバス要素をプログラムにより作成できます。関数 Simulink.Bus.createObject を使用して、バスオブジェクトを作成するモデルとブロックを指定します。関数を使用する前に、モデルはコンパイル可能でなければなりません。たとえば、入れ子になったバス階層の最上位で Bus Creator ブロックを指定すると、関数によって階層内のすべてのバスのバスオブジェクトが作成されます。バスオブジェクトをベースワークスペースに作成するか、または MATLAB ファイルに保存するか指定できます。

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

関数 Simulink.Bus.cellToObject を使用して、MATLAB でバス情報の cell 配列からバスオブジェクトを作成できます。各セルの下位の cell 配列はバスオブジェクトを表し、次のデータを含み、Simulink.Bus オブジェクトのプロパティが反映されます。

{BusName,HeaderFile,Description,DataScope,Alignment,Elements}

Elements フィールドは、各 Simulink.Bus オブジェクトに対してこれらのプロパティを定義する cell 配列です。

{ElementName,Dimensions,DataType,SampleTime,Complexity,DimensionsMode,Min,Max,Units,Description}

関数 Simulink.Bus.createObject を使用して、timeseries オブジェクトの MATLAB 構造体からバスオブジェクトを作成できます。または、数値の MATLAB 構造体を指定できます。バスオブジェクトをベースワークスペースに作成するか、または MATLAB ファイルに保存するか指定できます。

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

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