ボックスを使用したチャート オブジェクトのグループ化

"ボックス" は、ステート、関数、データなど、チャート内のオブジェクトの整理に使用できる名前空間を定義するグラフィカル オブジェクトです。ボックスを使用すると、チャートを即座に見て、特定のタスクをともに実行するステートまたは関数を認識できます。

角の丸いステートと区別するために、ボックスの角は四角になっています。ボックスは、MATLAB® 内のスタンドアロンの Stateflow® チャートではサポートされません。

メモ

Stateflow チャートにメモを追加するには、ボックスではなく注釈を使用します。詳細については、チャート内への説明コメントの追加を参照してください。

次のチャートのボックス Heater は、関連性のあるステート Off と On をグループ化しています。

Chart modeling a bang-bang controller.

この例の詳細については、バンバン温度制御システムのモデル化を参照してください。

Stateflow ボックスのセマンティクス

ボックス内のグラフィカル オブジェクトの階層構造

ボックスにより、階層レベルが Stateflow チャートに追加されます。ボックス外からボックスペアレントの関数またはステートを参照する場合は、パスにボックス名を含める必要があります。ボックスを使用した関数のグループ化を参照してください。

ボックスの使用に関するガイドライン

ボックスの使用時には、以下が適用されます。

  • ボックス外の場所からドット表記を使って、ボックスペアレントの関数またはステートを参照する場合は、パスにボックス名を含めます。

  • ボックスにデータを追加し、ボックス内のすべての要素が同じデータを共有できるようにします。

  • ボックスとそのコンテンツを単一のグラフィカル要素にグループ化できます。ステートのグループ化を参照してください。

  • ボックスをサブチャート化して、その要素を非表示にすることができます。サブチャートを使用したモーダル ロジックのカプセル化を参照してください。

  • entry、during、exit アクションなど、ボックスに対してアクション ステートメントを定義することはできません。

  • ボックス間の遷移を定義することはできません。ただし、ボックス内のステート間の遷移を定義することは可能です。

ボックスの描画と編集

ボックスの作成

チャート内にボックスを作成するには、オブジェクト パレットのボックス アイコンを使用します。

  1. オブジェクト パレットで、ボックス ツール をクリックします。

  2. チャート キャンバスで、新しいボックスの位置をクリックします。新しいボックスが表示され、名前を追加する位置にカーソルが表示されます。

  3. ボックスの名前を入力してから、ボックスの外部をクリックします。

ボックスの削除

ボックスを削除するには、そのボックスをクリックして "Delete" キーを押します。

ボックスの使用例

ボックスを使用した関数のグループ化

以下のチャートは、2 つの MATLAB 関数をグループ化した Status という名前のボックスを示しています。

Chart that uses a box to group two MATLAB functions.

このチャートは次の順序で実行されます。

  1. ステート Cold が最初にアクティブになります。

  2. 入力後、ステート Cold によって関数 Status.msgCold が呼び出されます。

    この関数は、温度が低いことを示すステータス メッセージを表示します。

    メモ

    MATLAB 関数はボックス内に配置されているので、関数呼び出しのパスにはボックス名 Status を含めなければなりません。この接頭辞を省略した場合は、エラー メッセージが表示されます。

  3. 入力データ temp の値が 80 を上回った場合は、ステート Warm への遷移が発生します。

  4. 入力後、ステート Warm によって関数 Status.msgWarm が呼び出されます。

    この関数は、温度が高いことを示すステータス メッセージを表示します。

  5. 入力データ temp の値が 60 を下回った場合は、ステート Cold への遷移が発生します。

  6. シミュレーションが終了するまで、手順 2 から 5 が繰り返されます。

ボックスを使用したステートのグループ化

以下のチャートは、関連するステートをグループ化した Status という名前のボックスを示しています。

Chart that uses a box to group two parallel substates.

このチャートでは、次のように動作します。

  • ステート Temp が最初にアクティブになり、続いてステート Wind_Chill がアクティブになります。次に、ステート Monitor がアクティブになります。

    このアクティブ化の順序は、Temp と Wind_Chill が優先順位 1 のボックス内にあることに起因します。ボックスを削除した場合、アクティブ化は、Temp、Monitor、Wind_Chill の順序に変更されます。これは、ステートがこの順序で作成されたためです。詳細については、パラレル ステートの順序の維持を参照してください。

    Chart with a changed activation order of parallel states.

  • 入力データ temp に基づいて、サブステート間の遷移がパラレル ステート Status.Temp と Status.Wind_Chill で発生します。

  • Status.Temp.Cold から Status.Temp.Warm への遷移が発生した場合は、遷移条件 in(Status.Temp.Warm) が真になります。

  • Status.Temp.Warm から Status.Temp.Cold への遷移が発生した場合は、遷移条件 in(Status.Temp.Cold) が真になります。

    サブステート Status.Temp.Cold と Status.Temp.Warm がボックス内にあるため、in 演算子の引数にボックス名 Status を含めなければなりません。この接頭辞を省略した場合は、エラー メッセージが表示されます。in 演算子の詳細は、in 演算子を使用したステート アクティビティのチェック を参照してください。

参考

トピック