マスクを作成して Simulink とパラメーターを共有

Stateflow^® チャート、状態遷移表、真理値表のマスクを作成すると、Simulink^® モデル内でのブロックの使用方法や共有方法が簡単になります。マスクは内在するロジックを非表示にすることでブロックをカプセル化し、ブロックのユーザーインターフェイスを作成します。ブロックは次の方法でカスタマイズできます。

意味のあるアイコンと端子で外観を変更する。
パラメーターにユーザーインターフェイスを作成する。
カスタマイズされたドキュメンテーションを追加する。

どのパラメーターをマスクユーザーインターフェイスを通して変更するかを決定します。これらのパラメーターに意味のある説明を追加できます。たとえば、モデル sf_car では、shift_logic チャートにあるマスクを使用して、パラメーター TWAIT を調整できます。モデルを開くには次のように入力します。

openExample("stateflow/AutomaticTransmissionWithActiveStateDataExample")

[マスクパラメーター] ダイアログボックスを開くには、Stateflow チャートをダブルクリックします。このダイアログボックスには、パラメーターの説明 "Delay before gear change (tick)" と、値を編集するためのボックスが含まれます。この値は、マスク内のパラメーター TWAIT に関連付けられています。このボックス内の値を編集すると、Stateflow はシミュレーション中に TWAIT に新しい値を代入します。

Mask Parameters dialog box for shift_logic chart.

チェックボックス、コンテキストメニュー、オプションボタンなど、マスクパラメーター用に他のタイプのユーザーインターフェイスを作成できます。

マスクは、Simulink ライブラリからアクセスできる Stateflow ブロック (チャート、状態遷移表、真理値表) 上で作成できます。チャート内で、Atomic サブチャートやステートなどのオブジェクトをマスクすることはできません。

詳細については、ブロックマスクの作成 (Simulink)を参照してください。

Stateflow チャート用のマスクの作成

モデル old_sf_car の Stateflow チャートにマスクを作成するには、次の手順に従います。

モデルを開きます。

openExample("stateflow/AutomaticTransmissionLegacyExample")

This image shows the example model from running the command above.

Simulink エディターで、チャート shift_logic を選択します。
マスクエディターを開きます。[ステートチャート] タブで、[マスクの作成] をクリックします。

マスクへのアイコンの追加

ブロックアイコンの外観をカスタマイズするには、描画コマンドを使用するか、イメージを読み込みます。詳細については、マスクの表示と初期化のコマンド (Simulink)を参照してください。

マスクエディターで、[アイコン] タブを選択します。
エディットボックスで、以下を入力します。
```
image("shift_logic.svg")
```
[マスクの保存] をクリックします。

マスクへのパラメーターの追加

Stateflow ブロック用のマスクを作成するとき、ブロックパラメーターにカスタムインターフェイスを定義できます。ブロックパラメーターには、マスクエディターに同じ名前の対応するパラメーターを定義することでアクセスします。すると、マスクのパラメーターダイアログボックスを通じて、こうしたパラメーターへのユーザーインターフェイスが提供されます。マスクパラメーターは、編集可能なフィールドとして [マスクパラメーター] ダイアログボックスに表示されます。Stateflow は、シミュレーション中にこれらの値を対応するブロックパラメーターに適用します。

たとえば、チャート shift_logic はパラメーター TWAIT をもっています。TWAIT をパラメーターとしてマスクに追加するには、次の手順に従います。

マスクエディターで、[パラメーターとダイアログ] タブを選択します。
[コントロール] ペインの [パラメーター] で、[編集] アイコンをクリックします。
[プロンプト] で、[マスクパラメーター] ダイアログボックスにおける、新しいマスクパラメーター用のプロンプトを入力します。
```
Delay before gear change(tick)
```
[名前] の下に、マスク内のパラメーターの名前を入力します。
```
TWAIT
```
[マスクの保存] をクリックします。

新しいマスクの表示

マスクを作成すると、Simulink キャンバスに shift_logic チャートの新しいアイコンが表示されます。アイコンをダブルクリックすると、[マスクパラメーター] ダイアログボックスが開きます。このダイアログボックスには、パラメーター TWAIT のプロンプトがあります。エディットボックスの値が、シミュレーション中にパラメーター TWAIT に代入されます。

Simulink model that contains a Stateflow chart with a mask.

マスク内を表示

チャート上の [マスク内部を検索] バッジをクリックすることにより、マスクされたブロックの内容を表示および編集できます。このバッジはチャートの左下隅に下向き矢印で示されます。あるいは、[ステートチャート] タブで、[マスク内を表示] をクリックします。マスク内を表示しても、ブロックのマスクは解除されません。

マスクの編集

マスクを編集するには、[ステートチャート] タブで [マスクの編集] をクリックします。マスクエディターでは、マスクアイコンの変更、パラメーターの変更、ドキュメンテーションの追加が可能です。マスクを削除するには、マスクエディターの下の隅にある [マスクの解除] をクリックします。マスクを変更したら、[適用] をクリックして変更を保存します。