MATLAB Function ブロックパラメーター変数の設定

MATLAB Function ブロックで "パラメーター変数" を使用すると、複数の MATLAB Function ブロックのインスタンスで同じデータにアクセスできます。パラメーター変数はワークスペース内のデータに割り当てるか、ブロックマスクを作成してマスクパラメーターに変数を割り当てることができます。

ワークスペースデータへのパラメーター変数の割り当て

MATLAB Function ブロックのパラメーター変数の値は、ワークスペース変数または Simulink.Parameter オブジェクトから取得されます。パラメーター変数を作成する前に、次のスペースのいずれかでワークスペース変数または Simulink.Parameter オブジェクトを作成しなければなりません。

Simulink^® モデルワークスペース。
データディクショナリ。詳細については、データディクショナリとはを参照してください。
MATLAB^® ワークスペース。MATLAB を閉じた場合はデータを再定義しなければなりません。

ワークスペース変数またはオブジェクトをワークスペースで直接作成するか、MAT ファイルまたは MATLAB ファイルから変数を読み込むか、カスタム MATLAB コードで変数を作成できます。次の表に、それぞれのスペースの違いを示します。

データストレージスペース	可視性
モデルワークスペース	モデルに対してローカル
データディクショナリ	指定した Simulink モデルと共有
ベースワークスペース	すべての Simulink モデルで利用可能。

詳細については、Simulink モデルの変数とオブジェクトの保存場所の決定を参照してください。

ワークスペース変数またはオブジェクトを作成した後、MATLAB Function ブロックでパラメーター変数を作成できます。

MATLAB Function ブロックを開きます。
MATLAB Function ブロックエディターで、[関数] タブの [準備] セクションにある [データの編集] をクリックします。
[シンボル] ペインで、[データの作成] ボタンをクリックします。
変数を選択し、[スコープ] プロパティを設定します。[タイプ] 列でタイプのアイコンをクリックし、[パラメーターデータ] を選択します。[シンボル] ペインでは、[スコープ] が [パラメーター] に設定された変数は [パラメーターデータ] アイコンで示されます。
[名前] 列で、パラメーター変数の名前をワークスペース変数または Simulink.Parameter オブジェクトの名前に設定します。

MATLAB Function ブロックの変数の定義の詳細については、MATLAB Function ブロックの変数の作成と定義を参照してください。

MATLAB Function ブロックのパラメーター変数の例

モデルを開く

この例では、パラメーター変数をもつ MATLAB Function ブロックを使用します。この例では、ベースワークスペースの変数でパラメーター値の値を定義します。

MATLAB 関数は、パラメーター変数 const に Sine Wave ブロック信号の値を乗算します。MATLAB Function ブロックを開いてコードを確認します。

function y = fcn(u, const)

y = const*u;

モデルを読み込むと、"PreLoadFnc" コールバックが実行され、ベースワークスペース変数 const が定義されます。コールバックを表示するには、[モデル化] タブで [モデル設定]、[モデルプロパティ] をクリックします。[モデルプロパティ] ウィンドウの [コールバック] タブで [PreLoadFnc] をクリックします。

MATLAB® コマンドウィンドウで再定義することで変数を調整できます。

MATLAB Function ブロックで、[関数] タブの [データの編集] をクリックします。[シンボル] ペインで const をクリックします。プロパティインスペクターと [シンボル] ペインに const がパラメーター変数として表示されます。

パラメーター変数とワークスペース変数は同じ名前でなければなりません。この例では、ワークスペース変数の名前を変更せずにパラメーター変数の名前を変更しているためエラーになります。

マスクパラメーターへのパラメーター変数の割り当て

ブロックマスクを作成し、そのマスク内でパラメーターの値を設定することで、MATLAB Function ブロックのパラメーター変数に値を代入できます。マスクパラメーターにパラメーター変数を割り当てるには、次のようにします。

MATLAB Function ブロックを開きます。
MATLAB Function ブロックエディターで、[関数] タブの [準備] セクションにある [データの編集] をクリックします。
[シンボル] ペインで、[データの作成] ボタンをクリックします。
変数を選択し、[スコープ] プロパティを設定します。[タイプ] 列でタイプのアイコンをクリックし、[パラメーターデータ] を選択します。
[名前] 列でパラメーター変数の名前を設定し、ブロックを終了します。
モデルで MATLAB Function ブロックをマスクします。ブロックのマスクの作成の詳細については、マスクの基礎を参照してください。
[マスクエディター] ウィンドウの [パラメーターとダイアログ] ペインでパラメーターを追加します。パラメーター変数と同じ名前を使用します。
マスクを保存し、[マスクエディター] ウィンドウを終了します。

マスクされた MATLAB Function ブロックのパラメーター変数の例

モデルを開く

この例では、マスクを使用してパラメーター変数の値を設定します。

MATLAB 関数は、パラメーター変数 const に Sine Wave ブロック信号の値を乗算します。MATLAB Function ブロックの矢印アイコンをクリックしてコードを確認します。

function y = fcn(u, const)

y = const*u;

MATLAB Function ブロックをダブルクリックして const の値を調整できます。

ブロックマスクで [Set sine wave multiplier] パラメーターが定義されており、これはマスクエディターで編集できます。MATLAB Function ブロックでは、プロパティインスペクターにおいて const は [スコープ] が Parameter に設定されたデータとして定義されています。このプロパティは、[シンボル] ペインで const を選択するとプロパティインスペクターで表示できます。

パラメーター変数とマスクパラメーターは同じ名前でなければなりません。この例では、マスクパラメーターの名前を変更せずにパラメーター変数の名前を変更しているためエラーになります。調整可能でないパラメーターを使用する場合、プロパティインスペクターで [調整可能] プロパティがオフになっていることを確認してください。

パラメーター変数の階層

パラメーター変数を定義すると、記号の関連付けと同じルールを使用して、その変数の代入が Simulink で検索されて選択されます。記号の解釈を参照してください。同じ名前の変数がそのブロックから見える複数のワークスペース内にある場合、ワークスペース階層内でそのブロックに最も近いデータが使用されます。MATLAB Function ブロックがマスクサブシステム内にある場合は、サブシステムワークスペースのデータが使用されます。それ以外の場合は、モデルワークスペースのデータが使用され、続いて MATLAB ベースワークスペースのデータおよび関連付けられた Simulink データディクショナリのデータがこの順序で使用されます。

参考

MATLAB Function