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

Simulink.Bus.createObject

パッケージ: Simulink.Bus

ブロックまたは MATLAB 構造体からのバス オブジェクトの作成

構文

busInfo = Simulink.Bus.createObject(model,blocks)

busInfo = Simulink.Bus.createObject(struct)

busInfo = Simulink.Bus.createObject(___,file)

busInfo = Simulink.Bus.createObject(___,format)

説明

busInfo = Simulink.Bus.createObject(model,blocks) は、指定されたブロックの Simulink.Bus オブジェクトを作成し、作成されたバス オブジェクトについての情報を返します。これらのバス オブジェクトは MATLAB^® ベース ワークスペースで実行され、使用できる場合はデータ ディクショナリがモデルによって使用されます。

busInfo = Simulink.Bus.createObject(struct) は、MATLAB timeseries、MATLAB timetable、および matlab.io.datastore.SimulationDatastore オブジェクトを含むことができる構造体または数値構造体からバス オブジェクトを作成します。これらのバス オブジェクトは MATLAB ベース ワークスペースで実行され、使用できる場合はデータ ディクショナリがモデルによって使用されます。

busInfo = Simulink.Bus.createObject(___,file) は、バス オブジェクトを cell 配列の cell 配列を含む MATLAB ファイルに保存します。下位の各 cell 配列はバス オブジェクトを表し、次のデータを含んでいます。

• バス名

• ヘッダー ファイル

• 説明

• データ スコープ

• 配置

• 要素

要素フィールドは、各要素に関する次のデータを含んでいる配列です。

• 要素名

• 次元

• データ型

• サンプル時間

• 実数/複素数

• 次元モード

• 最小値

• 最大値

• 単位

• 説明

busInfo = Simulink.Bus.createObject(___,format) は、バス オブジェクトをバス情報の入った cell 配列またはバス オブジェクト自体の入った cell 配列をもつファイルに保存します。

例

Bus Creator ブロックからバス オブジェクトを作成します。

モデルを開きます。

open_system('busdemo')

Bus Creator2 ブロックによって作成されたバスに対応するバス オブジェクトを作成します。

bus2Info = Simulink.Bus.createObject...
('busdemo','busdemo/Bus Creator2')

バス オブジェクトの作成およびファイルへの保存

ブロックを指定するブロック ハンドルを使って、2 つの Bus Creator ブロックからバス オブジェクトを作成します。ブロック ハンドルを変数に割り当て、ベクトル内で変数を使用して、バス オブジェクトの作成に使用されるブロックを指定します。

モデルを開きます。

open_system('busdemo')

Simulink^® エディターで、Bus Creator2 ブロックを選択します。

MATLAB で、ブロック ハンドルを変数に割り当てます。

bc2 = gcbh;

Simulink エディターで、Bus Creator ブロックを選択します。

MATLAB で、ブロック ハンドルを変数に割り当てます。

bc1 = gcbh;

バス オブジェクトを作成するには、ベクトル内でブロック ハンドル変数を使用します。

busInfo = Simulink.Bus.createObject...
('busdemo', [bc2 bc1], 'busdemo_busobject')

入力引数

model — モデル名またはハンドル

文字ベクトル

モデルの名前またはハンドル。文字ベクトルとして指定します。

blocks — バス オブジェクトを作成するブロック

文字ベクトル | ブロック パス名の cell 配列 | ブロック名のベクトル

バス オブジェクトを作成するブロック。文字ベクトル、ブロックのパス名の cell 配列、またはブロック ハンドルのベクトルとして指定します。

• ブロックが 1 つの場合は、ブロックの絶対パス名を指定します。

• ブロックが複数ある場合は、ブロックのパス名の cell 配列またはブロック ハンドルのベクトルのいずれかを指定します。

• バス階層の最上位レベルにある Bus Creator ブロックを指定した場合、階層内のすべてのバスに、関数によってバス オブジェクトが作成されます。

struct — バス オブジェクトの作成に使用される構造体

MATLAB timeseries、MATLAB timetable、および matlab.io.datastore.SimulationDatastore オブジェクトの構造体 | 数値構造体

バス オブジェクトの作成に使用される構造体。MATLAB timeseries、MATLAB timetable、および matlab.io.datastore.SimulationDatastore オブジェクトを含む構造体または数値構造体として指定します。

file — バス オブジェクト定義の保存に使用される MATLAB ファイル

文字ベクトル

バス オブジェクト定義の保存に使用される MATLAB ファイル。文字ベクトルとして指定します。ファイル名は一意でなければなりません。

format — バス オブジェクトをファイルに保存する形式

'cell' (既定値) | 'object'

バス オブジェクトをファイルに保存する形式。'cell' または 'object' のいずれかとして指定します。セル形式の方がコンパクトですが、オブジェクト形式の方が読みやすくなります。

出力引数

busInfo — 指定されたブロックのバス情報

構造体配列

指定されたブロックのバス情報。構造体配列として返されます。構造体配列の各要素は 1 つのブロックに対応し、次のフィールドがあります。

• block — ブロックのハンドル

• busName — ブロックに関連付けられているバス オブジェクトの名前

ヒント

モデル名を指定する場合、Simulink.Bus.createObject コマンドを使用する前に、モデルは正常にコンパイルされていなければなりません。

互換性についての考慮事項

Simulink.BusElement オブジェクトで SampleTime プロパティはサポートされなくなる

R2019b での開始は非推奨

将来のリリースで、Simulink.BusElement オブジェクトの SampleTime プロパティは削除されます。

備えとして次のようにします。

• BusElement オブジェクトを定義する際に、既定の SampleTime 値 (-1) を使用する。

• バスの要素のサンプル時間を指定するには、対応するブロックの SampleTime ブロック パラメーターを使用する。たとえば、In Bus Element、Out Bus Element、および Signal Specification ブロックを使用してサンプル時間を指定できます。

参考

Bus Creator | Simulink.Bus | Simulink.Bus.cellToObject | Simulink.Bus.createMATLABStruct | Simulink.Bus.objectToCell | Simulink.BusElement

トピック

• バス オブジェクトでのバス プロパティの指定
• プログラムによるバス オブジェクトの作成
• バス オブジェクトの作成と指定
• バス オブジェクトの保存

R2006a より前に導入