このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

Variant Source

バリアントを使用した複数の入力間での経路指定

• ライブラリ:

• Simulink / Signal Routing

• 

×

説明

Variant Source ブロックでは、信号のソースのコンポーネントについて、その複数の実装を単一のレイヤーに含めることができます。

たとえば、自動車のワイパーの速度を制御するために、このモデルをさまざまなレイン センサーを使用してシミュレートするとします。Variant Source ブロックで、さまざまなレイン センサーに切り替えます。この情報を使用して、制御ロジックで Variant Sink ブロックに結果を出力します。その後、Variant Sink ブロックで、シミュレーション時にワイパーのモーター モデルを切り替え、コード生成時にコマンドをセンサーに切り替えます。バリアント ブロックでの選択の切り替えは、Types of Variant Control Modes in Variant Blocksの選択に基づいて行われます。詳細については、バリアント制御の紹介を参照してください。

メモ

Variant Source ブロックの入力端子に接続されたバリアントの選択のうち、最大で 1 つがシミュレーション時にアクティブになります。

Variant Source ブロックには 1 つ以上の入力端子があり、出力端子は 1 つだけです。モデルの実行時に最大で 1 つの選択がアクティブになるように、ブロックの入力端子に可変の選択肢を接続できます。

Variant Source ブロックはバリアント制御モード, Variant control modeバリアント制御モードVariant control modeとバリアントのアクティベーションのタイミング, Variant activation timeバリアントのアクティベーションのタイミングVariant activation timeに関連付けられています。バリアント制御モードによって、バリアント制御の指定方法が決まります。バリアントのアクティベーションのタイミングによって、選択をアクティブにするタイミングが決まります。さらに、生成されたコードに、アクティブな選択のみを含めるか、またはアクティブな選択と非アクティブな選択の両方を含めるかを決定します。シミュレーション中、Simulink^® はアクティブな選択を Variant Source ブロックの出力端子に直接接続し、非アクティブな選択を無視します。

Variant Source ブロックを使用すると、次のことが可能です。

• モデル全体にバリアント条件を伝播します。

• バリアントの選択のすべての可能な実装をモデルの単一のレイヤーで可視化します。これにより、モデルの可読性が向上します。

• Simulink により、非アクティブなブロックがモデル全体から排除されます。これにより、実行時のパフォーマンスが向上します。すべてのバリアントの選択が非アクティブな場合、そのバリアント領域全体が Simulink によってモデルから削除されます。

• バリアント ソースとバリアント シンクは、バリアントの選択をすばやくモデル化するために使用できるバリアント コンポーネント インターフェイスを提供します。

ブロック アイコンのバリアント バッジの色とアイコンは、[バリアントのアクティベーションのタイミング] パラメーター、[バリアント制御モード] パラメーター、および [ゼロ アクティブ バリアント制御を許可] パラメーターの値に基づいて変化します。詳細については、バリアントのバッジを参照してください。

制限

Variant Source ブロックは、時間ベースの信号、関数呼び出し信号、およびアクション信号で動作します。SimEvents^®、Simscape™ Multibody™ またはその他の時間ベースでない信号はこれらのブロックで使用できません。

端子

入力

Port_1 — 最初のバリアント制御に関連付けられた入力端子

スカラー | ベクトル | 行列

最初のバリアント制御に関連付けられた入力端子。true と評価されるバリアント制御によって、アクティブになる入力端子が決まります。

データ型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image

Port_N — N 番目のバリアント制御に関連付けられた入力端子

スカラー | ベクトル | 行列

N 番目のバリアント制御に関連付けられた入力端子。true と評価されるバリアント制御によって、アクティブになる入力端子が決まります。

データ型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image

出力

Port_1 — アクティブなバリアントの出力

スカラー | ベクトル | 行列

アクティブなバリアントからの出力信号。

データ型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image

パラメーター

バリアント制御モード — バリアント制御モード

式 (既定値) | ラベル | sim/codegen の切り替え

アクティブなバリアント選択を決定するバリアント制御は次の型のいずれかにすることができます。

• 式 — [式] モードでは、Simulink はバリアント条件の評価に基づいてアクティブなバリアントを選択します。条件式が true と評価される場合、対応するバリアント選択がアクティブになります。条件式が false と評価される場合、対応するバリアント選択が非アクティブになります。Switch Between Choices Using Condition Expressions in Variant Blocksを参照してください。

• ラベル — [ラベル] モードでは、Simulink はバリアントの名前に基づいてアクティブなバリアントを選択します。バリアント制御は string であり、いずれのワークスペースでも、いずれの変数も作成する必要はありません。Switch Between Choices Using Labels in Variant Blocksを参照してください。

• sim/codegen の切り替え — ワークスペース変数を作成せずに、シミュレーションのためのバリアントとコード生成ワークフローを自動的に切り替えるには、[sim/codegen の切り替え] モードを使用します。モデルをシミュレーションするときに、Simulink はアクティブな選択肢として sim 分岐を自動的に選択します。同様に、ソフトウェアインザループ (SIL) またはプロセッサインザループ (PIL) シミュレーションを実行したり、コードを生成したり、エクスターナル モードを使用したりするときに、Simulink は自動的に codegen 分岐を選択します。Switch Between Choices for Simulation and Code Generation Workflows Without Using Control Variables in Variant Blocksを参照してください。

バリアント制御モードの詳細については、バリアント制御の紹介を参照してください。バリアント制御モードのさまざまな種類の比較については、Compare Different Types of Variant Control Modes in Variant Blocksを参照してください。

依存関係

使用できるさまざまなバリアントのアクティベーションのタイミングは、指定する [バリアント制御モード] の種類によって異なります。[バリアントのアクティベーションのタイミング] パラメーターに応じて、アクティブな選択肢が Simulink で設定されるタイミングが決まります。生成されたコードに含まれる変動性も、このパラメーターで決まります。次の表に、それぞれのバリアント制御モードでサポートされるバリアントのアクティベーションのタイミングを示します。

バリアントのアクティベーションのタイミング
バリアント制御モード	ブロック線図の更新	ブロック線図の更新時にすべての選択肢を解析	コードのコンパイル	起動
式	✓	✓	✓	✓
ラベル	✓	x	x	x
sim/codegen の切り替え	✓	✓	x	x

バリアントのアクティベーションのタイミング — Simulink がアクティブなバリアントの選択を選択するタイミング

ブロック線図の更新 (既定値) | ブロック線図の更新時にすべての選択肢を解析 | コードのコンパイル | 起動

このパラメーターはシミュレーションおよびコード生成のワークフローに含める変動性を決定します。詳細については、Activate Variant During Different Stages of Simulation and Code Generation Workflowを参照してください。

[バリアントのアクティベーションのタイミング] パラメーターは、次のように設定できます。

• ブロック線図の更新 — モデルの実行時、シミュレーションおよびコード生成のワークフローにはアクティブな選択肢のみが含まれます。生成されたコードには、アクティブな選択肢のみが含まれます。

• ブロック線図の更新時にすべての選択肢を解析 — モデルの実行時、アクティブな選択肢と非アクティブな選択肢の両方の一貫性がモデル全体で解析されます。ただし、シミュレーションおよびコード生成のワークフローにはアクティブな選択肢のみが含まれます。生成されたコードには、アクティブな選択肢のみが含まれます。

• コードのコンパイル — モデルの実行時、アクティブな選択肢と非アクティブな選択肢の両方の一貫性がモデル全体で解析され、すべての選択肢がシミュレーションおよびコード生成のワークフローに含まれます。生成されたコードにはアクティブな選択肢と非アクティブな選択肢の両方が、プリプロセッサ条件 #if と #elif に囲まれて含まれます。ただし、生成されたコードからビルドされる実行可能ファイルには、アクティブな選択肢のみが含まれます。

• 起動 — モデルの実行時、アクティブな選択肢と非アクティブな選択肢の両方の一貫性がモデル全体で解析され、すべての選択肢がシミュレーションおよびコード生成のワークフローに含まれます。このオプションでは、高速リスタートを使用して対話型シミュレーションの速度を向上させることができます。詳細については、Run Iterative Simulations Without Recompiling Model for Variant Systems Using Fast Restartを参照してください。モデルから生成されたコードには、通常の if 条件で囲まれたアクティブな選択肢と非アクティブな選択肢の両方が含まれます。生成されたコードからビルドされる実行可能ファイルにも、アクティブな選択肢と非アクティブな選択肢の両方が含まれます。

依存関係

使用できるバリアントのアクティベーションのタイミングは、指定するバリアント制御モードの種類によって異なります。[バリアントのアクティベーションのタイミング] パラメーターに応じて、アクティブな選択肢が Simulink で設定されるタイミングが決まります。生成されたコードに含まれる変動性も、このパラメーターで決まります。次の表に、それぞれのバリアント制御モードでサポートされるバリアントのアクティベーションのタイミングを示します。

バリアントのアクティベーションのタイミング
バリアント制御モード	ブロック線図の更新	ブロック線図の更新時にすべての選択肢を解析	コードのコンパイル	起動
式	✓	✓	✓	✓
ラベル	✓	x	x	x
sim/codegen の切り替え	✓	✓	x	x

プログラムでの使用

ブロック パラメーター: VariantActivationTime

型: 文字ベクトル

値: [ブロック線図の更新] | [ブロック線図の更新時にすべての選択肢を解析] | [コードのコンパイル] | [起動]

既定の設定: [ブロック線図の更新]

端子および関連付けられている条件 — バリアントの選択、バリアント制御および条件に関するテーブル

空のテーブル (既定値)

テーブルには、Variant Source ブロックの入力端子に接続されたバリアントの選択ごとに 1 つの行があります。バリアント選択が存在しない場合、テーブルは空になります。

[端子および関連付けられている条件] テーブルの左にあるボタンを使用して、テーブルの要素を変更できます。

目的	クリックするボタン
新しい入力端子を追加します: 新しい入力端子をバリアントの選択として作成し、その新しい選択肢のエントリをテーブルに追加します。
選択した端子を削除します: 選択したバリアントの選択をブロックから削除し、そのエントリをテーブルから削除します。
選択されている Variant オブジェクトを作成/編集: 選択したバリアントの選択の Simulink.Variant オブジェクトをグローバル ワークスペースで作成または編集し、Simulink.Variant オブジェクトのパラメーター ダイアログ ボックスを使用してバリアント条件を指定します。 メモ ベース ワークスペースを使用するモデルの場合、この操作によって Simulink.Variant オブジェクトがベース ワークスペースに作成されます。このオブジェクトは現在の MATLAB セッションに対してのみ使用できます。データを永続的に保存するには、オブジェクトを MAT ファイルまたは MATLAB スクリプトに保存します。

端子 — 接続済みの入力端子の数

既定値なし

Variant Source ブロックの上流で 1 つのバリアントの選択に接続されている入力端子の数。この値は読み取り専用です。

端子を追加するには をクリックし、既存の端子を削除するには をクリックします。

バリアント制御ラベル — label モードでの選択肢の名前

true または false (既定値) | string

選択肢の名前。string として指定されます。

依存関係

このパラメーターを有効にするには、[バリアント制御モード] を [ラベル] に設定します。

バリアント制御式 — アクティブな選択肢を決定する条件式

true または false (既定値) | boolean の条件式 | boolean の条件式を表す Simulink.Variant オブジェクト | (default)

アクティブな選択肢を決定する条件式を指定します。条件式が true と評価される場合、Simulink は対応するバリアント選択をアクティブにします。条件式が false と評価される場合、Simulink は対応するバリアント選択を非アクティブにします。

バリアント制御は、次のいずれかにすることができます。

• ラピッド プロトタイピングの場合は boolean の条件式。たとえば、A == 1、A ~= B、A && B == 1 など。

• 条件の再使用の場合は条件式を含む Simulink.Variant オブジェクト。Simulink.Variant Objects for Variant Condition Reuse of Variant Blocksを参照してください。

• true と評価される選択肢がない場合は既定のバリアントの選択。

ここで A および B は "バリアント制御変数" と呼ばれるオペランドです。==、~=、および && は、条件式の演算子です。条件式には、そのようなバリアント制御変数と演算子を 1 つ以上含めることができます。バリアント制御変数のサポートされる型と保存場所の詳細については、Types of Variant Control Variables (Operands) in Variant BlocksおよびStorage Locations for Variant Control Variables (Operands) in Variant Blocksを参照してください。演算子の詳細については、Types of Operators in Variant Blocks for Different Activation Timesを参照してください。

詳細については、Switch Between Choices Using Condition Expressions in Variant Blocksを参照してください。

プログラムでの使用

構造体フィールド: Variant パラメーター構造体の読み取り専用 variant.Name フィールドによって表現されます

型: 文字ベクトル

値: バリアントの選択に関連付けられたバリアント制御

既定の設定: 'variant'

条件 (読み取り専用) — Simulink.Variant オブジェクト内の条件式

N/A (既定値)

この読み取り専用のフィールドには、Simulink.Variant オブジェクトとして指定されている条件式が表示されます。条件式を変更または編集するには、ワークスペースでオブジェクトをダブルクリックすると表示される Simulink.Variant パラメーター ダイアログ ボックスを使用します。

メモ

型 Simulink.Variant の条件式で指定するオペランドは、ベース ワークスペースまたはデータ ディクショナリで定義されていなければなりません。マスクまたはモデル ワークスペースで定義されているオペランドの指定はサポートされません。

ラベル モードのアクティブな選択肢 — label モードのアクティブな選択肢の名前

true(Subsystem) (既定値) | false(Subsystem1)

このリストには、バリアントの選択すべてのラベルが含まれています。アクティブな選択肢を設定するには、リストからラベルを選択します。対応する選択肢がアクティブになります。または、Set Active Choices Using Variant Control Labelsで説明している方法に従って、ラベル モードのアクティブな選択肢を変更できます。

依存関係

このパラメーターを有効にするには、[バリアント制御モード] パラメーターを [ラベル] に設定します。

プログラムでの使用

パラメーター: LabelModeActivechoice

型: 文字ベクトル

値: ラベル モードのアクティブな選択肢が指定されない場合、値は空です。ラベル モードのアクティブな選択肢が指定される場合、値はラベル モードのアクティブな選択肢の名前です。

既定の設定: ''

ゼロ アクティブ バリアント制御を許可 — アクティブなバリアントの選択なしでモデルをシミュレート

off (既定値) | on

• off — アクティブなバリアントの選択がないと、Simulink でエラーが発生します。

• on — このオプションを選択すると、アクティブなバリアントの選択がない場合に、Simulink は Variant Source ブロックに接続されたバリアントの選択なしでモデルのシミュレーションを行います。Simulink は Variant Source ブロックの入力ストリームと出力ストリームに接続されているすべてのブロックの接続を解除し、それによってモデルからバリアント領域を完全に削除します。

  生成コードでは、Variant Source ブロックの入力ストリームと出力ストリームに接続されたすべてのブロックが条件付きになります。

説明の節で示した自動車のワイパーの例で考えてみます。ここでは、自動車のワイパーの手動操作のみをシミュレートするとします。そのため、モデルのレイン センサーの設定は必要ありません。[ゼロ アクティブ バリアント制御を許可] を on に設定すると、Rain Sensor Variant Source ブロックにアクティブなバリアントの選択がない場合、Simulink は Rain Sensor Variant Source ブロックとそれに接続されているすべてのブロックの接続を解除し、モデルからバリアント領域を完全に削除します。

次の表に、アクティベーションのタイミングが [コードのコンパイル] のコードの生成について、[ゼロ アクティブ バリアント制御を許可] パラメーターを使用する場合と使用しない場合のコードを示します。[ゼロ アクティブ バリアント制御を許可] を off に設定した生成コードでは、バリアントの選択の Rain Sensor Model 1 と Rain Sensor Model 2 が条件付きになります。F1 ブロックは無条件であるため、選択肢のいずれかに対して実行されます。このコードは、選択肢のいずれかが true と評価されるシナリオのみをサポートします。true と評価される選択肢がない場合は、両方の選択肢がコンパイルから削除されます。F1 ブロックが無効な入力を受信するためエラーになります。[ゼロ アクティブ バリアント制御を許可] を on に設定した生成コードでは、バリアントの選択の Rain Sensor Model 1 と Rain Sensor Model 2、および接続された F1 ブロックが条件付きになります。そのため、true と評価される選択肢がない場合は、F1 ブロックも削除されるため、そのバリアント領域をコードのコンパイルから完全に削除できます。

[ゼロ アクティブ バリアント制御を許可] を使用しない生成コード	[ゼロ アクティブ バリアント制御を許可] を使用した生成コード
# if R == 1 /* logic for Rain Sensor Model 1; */ # elif R == 2 /* logic for Rain Sensor Model 2; */ # endif /* If none of the conditions R == 1 or R == 2 evaluate to true, the filter F1 receives an invalid input which resuls in an error.*/ /* logic for filter F1; */	# if R == 1 /* logic for Rain Sensor Model 1; */ # elif R == 2 /* logic for Rain Sensor Model 2; */ # endif /* The logic for filter F1 is executed only if either of the conditions evaluate to true. F1 is removed from code compilation if none of the condition evaluates to true. */ # if (R == 1) ∥ (R == 2) /* logic for filter F1; */ # endif

依存関係

このパラメーターは、[バリアント制御モード] を [式] に設定する場合にのみ使用できます。

プログラムでの使用

ブロック パラメーター: AllowZeroVariantControls

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

関数呼び出しの出力 — 関数呼び出し信号を受信および出力

off (既定値) | on

このパラメーターを選択すると、Simulink において、Variant Source ブロックの入力端子で関数呼び出し信号を受け取り、その信号を出力端子で条件付きでマージできるようになります。詳細については、Propagate Variant Conditions from Variant Source Blocks to Conditionally Executed Subsystemsを参照してください。

プログラムでの使用

ブロック パラメーター: OutputFunctionCall

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

ブロックのバリアント条件を表示 — ブロック端子への注釈付け

off (既定値) | on

このオプションを選択すると、Simulink で Variant Source ブロックの各端子のバリアント条件式に注釈が付けられます。

プログラムでの使用

ブロック パラメーター: ShowConditionOnBlock

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

モデルの例

Variant Source ブロックと Variant Sink ブロック

Variant Source と Variant Sink ブロックでバリアントの選択を定義します。

モデルを開く

ブロックの特性

データ型	Boolean | bus | double | enumerated | fixed point | half | integer | single | string
直達	いいえ
多次元信号	いいえ
可変サイズの信号	いいえ
ゼロクロッシング検出	いいえ

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

固定小数点の変換
Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

バージョン履歴

R2016a で導入

参考

Variant Sink | Manual Variant Source | Manual Variant Sink | Variant Subsystem

トピック

• バリアントの選択の取り扱い
• Represent Variant Source and Sink Blocks in Generated Code (Embedded Coder)