バリアントの定義、設定および有効化

バリアントの選択の表現

バリアントの選択には、モデルの 2 つ以上のコンポーネントのコンフィギュレーションがあります。次の例は、モデルの Variant Subsystem ブロック内のバリアント選択を表現する方法を示しています。設計バリアントを表現する他の方法については、Simulink におけるバリアントの表現のオプションを参照してください。

Variant Subsystem ブロックをモデルに追加し、名前を付けます。
このブロックはバリアントの選択のコンテナーとして使用します。
Variant Subsystem ブロックをダブルクリックします。このブロックの入力および出力が一致するように、Inport ブロックと Outport ブロックを追加します。

メモ
Variant Subsystem ブロックには、Inport、Outport、Subsystem および Model ブロックのみを追加できます。データ端子を通して制御信号を渡すことができます。
Variant Subsystem ブロック上のバッジを右クリックし、[ブロックパラメーター (Subsystem)] を選択します。
[ブロックパラメーター] ダイアログボックスで、追加するバリアントサブシステムの選択ごとにボタンをクリックします。
Simulink^® により空の Subsystem ブロックが Variant Subsystem ブロック内に作成されます。新しいブロックには、含んでいる Variant Subsystem ブロックと同じ数の入力端子および出力端子があります

ヒント
(バリアントの選択で入力端子と出力端子の数が異なる場合は、バリアントの選択の入力端子と出力端子のマッピングを参照してください)。
各 Subsystem ブロックを開き、バリアントの選択を表すモデルを作成します。
バリアントのプロトタイプを作成しているときに、Variant Subsystem ブロック内の入力または出力がない、空の Subsystem ブロックを作成できます。空のサブシステムによって、バリアントの完全なモデル化の必要がない、サブシステムが非アクティブな状況が再現されます。空のバリアントの選択では、バリアントのアクティブ化条件を指定するか、条件の前に % 記号を付けてバリアント条件をコメントアウトします。
空のバリアントの選択がコンパイル中にアクティブである場合、Simulink はそれを無視します。

バリアントの選択として Simulink モデルを含める

Simulink モデルをバリアントの選択として Variant Subsystem ブロック内に含めることができます。

バリアントの選択として含めるモデルを作成します。含んでいる Variant Subsystem ブロックと同じ数の入力端子と出力端子がモデルにあることを確認します。
メモ
モデルに含まれる入力端子と出力端子の数が異なる場合は、バリアントの選択の入力端子と出力端子のマッピングを参照してください。
モデルで、バリアントの選択を含む Variant Subsystem ブロックを右クリックし、[ブロックパラメーター (Subsystem)] を選択します。
[ブロックパラメーター] ダイアログボックスでボタンをクリックし、Model ブロックをバリアントの選択として追加します。
Simulink により関連付けられていない Model ブロックが Variant Subsystem ブロックに作成されます。
関連付けられていない Model ブロックをダブルクリックします。[モデル名] ボックスにモデルバリアントの選択として使用するモデル名を入力し、[OK] をクリックします。

バリアント制御の設定

バリアント制御を使用して、バリアントの選択をアクティブ化する条件を指定できます。また、最大で 1 つのバリアントの選択を既定として指定できます。

MATLAB^® コマンドプロンプトで、組み合わせたときにアクティブ化する条件を作成する制御変数を指定します。
```
mode = 3;
version = 2;
```
モデルのバリアントの選択のコンテナーである Variant Subsystem ブロックを右クリックし、[ブロックパラメーター (Subsystem)] を選択します。
[ブロックパラメーター] ダイアログボックスの [バリアント制御] 列で、いずれかの選択肢の横にある [(既定の設定)] を選択します。
Simulink は、シミュレーションで 1 つのバリアントの選択のみがアクティブになることを検証します。[ゼロアクティブバリアント制御を許可] が選択されている場合、ゼロバリアントの選択ができます。制御条件でバリアントがアクティブにならない場合、Simulink はシミュレーションに既定のバリアントとコード生成を使用します。
他の各選択に対してバリアント条件を指定します。空のバリアントの選択を使用している場合、その選択に対するバリアント条件を指定します。既存のアクティブ化条件の先頭に % 記号を付けてコメントアウトすることもできます。
[適用] をクリックします。そうしない場合は変更内容は保存されません。

バリアントへの変換

Simulink エディターでは、次のブロックを Variant Subsystem ブロックに変換できます。

Subsystem ブロック
Model ブロック
Variant Model ブロック (R2017b より前のバージョンで作成されたモデル)
条件付き実行サブシステム

これを行うには、ブロックを右クリックし、コンテキストメニューで [サブシステムとモデル参照] 、 [変換] 、 [Variant Subsystem] をクリックします。

これらのブロックはプログラムで Variant Subsystem ブロックに変換することもできます。これを行うには、次のいずれかの構文を使用します。

Simulink.VariantManager.convertToVariant(gcb)
Simulink.VariantManager.convertToVariant(gcbh)

以下に例を示します。

open_system('sldemo_variant_subsystems');
Simulink.VariantManager.convertToVariant('sldemo_variant_subsystems/Controller');

バリアントモデルをバリアントサブシステムに変換する場合、Model ブロックのパラメーター [プリプロセッサの条件を生成] の動作が Variant Subsystem ブロックのパラメーター [バリアントのアクティベーションのタイミング] と異なることに注意してください。バリアントモデルの場合、このパラメーターを有効にすると、シミュレーションとブロック線図の更新でコンパイルされるのはアクティブなバリアントのみになります。バリアントサブシステムの場合、このパラメーターを有効にするとすべてのバリアントがコンパイルされるため、シミュレーションと更新が低速になる可能性があります。

バリアントモデルのバリアントサブシステムへの変換では Variants コマンドラインパラメーターを使用するスクリプトの更新が必要になる可能性があります。