Atomic サブチャートおよびボックスでの変数のマッピング

Atomic サブチャートは、Stateflow^® チャートで再利用可能なサブコンポーネントを作成する際に役立つグラフィカルオブジェクトです。Atomic ボックスは、グラフィカル関数、真理値表関数、MATLAB^® 関数および Simulink^® 関数を共有する際に役立つグラフィカルオブジェクトです。Atomic サブチャートとボックスは、MATLAB 内のスタンドアロンの Stateflow チャートではサポートされません。詳細については、Atomic サブチャート使用した再利用可能なサブコンポーネントの作成およびAtomic ボックスを使用した関数の再利用を参照してください。

Atomic サブチャートまたはボックスの各シンボルが、メインチャートの正しいシンボルに確実にアクセスするようにするには、サブチャートシンボルのマッピングを編集します。サブチャートまたはボックスを右クリックして、[サブチャートのマッピング] を選択します。プロパティダイアログボックスの [マッピング] タブで、[メインチャートシンボル] ドロップダウンリストを使用して、サブチャートの各シンボルに対応するメインチャートのシンボルを指定します。あるいは、以下を指定する式を入力できます。

Stateflow 構造体のフィールド。Stateflow 構造体へのインデックス付けと値の割り当てを参照してください。
ベクトルまたは行列の要素。Stateflow でのベクトルおよび行列の演算を参照してください。
構造体のフィールドまたは行列のインデックスの有効な組み合わせ (struct.field(1,2) や struct.field[0][1] など)。

[メインチャートシンボル] フィールドを空のままにする場合、Stateflow は、Atomic サブチャートシンボルを同じ名前のメインチャートシンボルにマッピングしようとします。

Atomic サブチャート内のシンボルは、メインチャート内の異なるスコープをもつシンボルにマッピングできます。次の表は可能なマッピングをまとめています。

Atomic サブチャートシンボルのスコープ	メインチャートシンボルのスコープ
入力	入力、出力、ローカル、パラメーター
出力	出力、ローカル
パラメーター	パラメーター
データストアメモリ	データストアメモリ、ローカル
入力イベント	入力イベント

Atomic サブチャートのデータストアメモリを列挙型のローカルデータにマッピングする場合、データストアメモリの初期値を指定するには 2 つのオプションがあります。

[データプロパティ] ダイアログボックスで、チャートレベルのローカルデータの [初期値] フィールドを設定する。
列挙型の既定値を適用するために、[初期値] フィールドを空のままにする。

Atomic サブチャートの入力データおよび出力データのマッピング

この例では次を使用します。

モデルを開く

次のモデルには、チャートに入力信号を供給する Sine Wave ブロックが 2 つ含まれています。

次のチャートは、同じライブラリからリンクされている 2 つの Atomic サブチャートで構成されています。

どちらの Atomic サブチャートにも、入力正弦波を同じ周波数の出力矩形波に変換するための飽和論理があります。

モデルのシミュレーションを行うと、y2 の出力はゼロになります。

Atomic サブチャート A 内のシンボルはメインチャート内のシンボル u1 および y1 と同じ名前をもつため、正しい変数にマッピングされます。Atomic サブチャート B 内のシンボルはメインチャート内の u2 および y2 にマッピングされないため、マッピングを編集しなければなりません。

サブチャート B を右クリックし、[サブチャートのマッピング] を選択します。
[Input マッピング] で、u1 のメインチャートシンボルが u2 になるように指定します。
[Output マッピング] で、y1 のメインチャートシンボルが y2 になるように指定します。
[OK] をクリックします。

モデルを再度実行すると、次の結果が得られます。

Atomic サブチャート変数のバス要素へのマッピング

この例では次を使用します。

モデルを開く

次のモデルには、バスを介してチャートに信号を供給する Sine Wave ブロックが 2 つ含まれています。

次のチャートは、同じライブラリからリンクされている 2 つの Atomic サブチャートで構成されています。どちらの Atomic サブチャートにも、入力正弦波を同じ周波数の出力矩形波に変換するための飽和論理があります。

モデルのシミュレーションを行うと、各サブチャートで、入力 u1 がメインチャートのどの変数にもマップしないため、エラーが発生します。各サブチャートで u1 のマッピングを編集するには、次を行います。

サブチャート A を右クリックし、[サブチャートのマッピング] を選択します。
[Input マッピング] で、u1 のメインチャートシンボルがバス内の最初の要素 BusIn.u1 になるように指定します。
[OK] をクリックします。
サブチャート B でこれを繰り返して、u1 のメインチャートシンボルがバス内の 2 番目の要素 BusIn.u2 になるように指定します。

モデルを再度実行すると、次の結果が得られます。

Atomic サブチャート変数を行列の要素にマッピング

この例では次を使用します。

モデルを開く

ベクトルまたは行列の要素を参照するときは、チャートのアクション言語にかかわらず、以下を使用します。

かっこやコンマで区切られた 1 ベースのインデックス (たとえば、A(4,5))。
大かっこで区切られた 0 ベースのインデックス (たとえば、A[3][4])。

インデックスには、チャート内の数値またはパラメーターを指定できます。その他の式をインデックスとして使用することはサポートされていません。

たとえば、次のモデルには、対角行列を介してチャートに信号を供給する Sine Wave ブロックが 2 つ含まれています。

サブチャート A を右クリックし、[サブチャートのマッピング] を選択します。
[Input マッピング] で、u1 のメインチャートシンボルが行列の左上の要素になるように指定します。この要素の 0 ベースのインデックス形式は M[0][0] です。
[OK] をクリックします。
サブチャート B でこれを繰り返して、u1 のメインチャートシンボルが行列の右下の要素になるように指定します。この要素の 1 ベースのインデックス形式は M(2,2) です。

モデルを再度実行すると、次の結果が得られます。

式への Atomic サブチャートパラメーターのマッピング

この例では次を使用します。

モデルを開く

Atomic サブチャートのパラメーターについて、定数、ベースワークスペース内の変数、メインチャート内のパラメーターを結合する式を指定できます。

たとえば、次のモデルには、チャートに入力信号を供給する Sine Wave ブロックが 2 つ含まれています。

モデルのシミュレーションを行うと、パラメーター T が未定義のためエラーが発生します。このエラーを修正するため、T の式がメインチャートで評価されるように指定します。

サブチャート A を右クリックし、[サブチャートのマッピング] を選択します。
[Parameter マッピング] で、T の値として -1 を入力します。
[OK] をクリックします。
サブチャート B でこれを繰り返して、T の値を 2 と指定します。

モデルを再度実行すると、次の結果が得られます。

Atomic サブチャートの入力イベントのマッピング

この例では次を使用します。

モデルを開く

このモデルは入力イベントをチャートに供給する Mux ブロックを含んでいます。

チャートは以下の 2 つのスーパーステートを含んでいます。Active と Inactive を定義します。Active ステートは入力イベントを使用して、異なるサブステートの間の遷移を保護します。

Active ステートを Atomic サブチャートに変換するには、以下を行います。

Active ステートを右クリックし、[グループとサブチャート]、[Atomic サブチャート] を選択します。
Atomic サブチャートを右クリックし、[サブチャートのマッピング] を選択します。
[Input Event マッピング] において、各 Atomic サブチャートシンボルはメインチャート内の正しい入力イベントにマッピングされています。
[OK] をクリックします。

Atomic サブチャートの入力イベントを無効にする

Atomic サブチャート内のすべてのイベントがメインチャートのイベントに対応している必要はありません。たとえば、ライブラリチャートで定義されているイベントのセット全体を使用しない、リンクされた Atomic サブチャートを作成できます。Atomic サブチャートの入力イベントを無効にするには、次の手順に従います。

Atomic サブチャートを右クリックし、[サブチャートのマッピング] を選択します。
[Input Event マッピング] の [メインチャートシンボル] ドロップダウンリストで、<disabled> を選択します。
[OK] をクリックします。