Simulink.VariantExpression クラス
名前空間: Simulink
バリアント選択を制御する条件を指定
説明
バリアント ブロックを含むモデルでは、各バリアント選択肢をバリアント制御に関連付ける必要があります。シミュレーション時、すべてのバリアント選択肢のバリアント制御が Simulink® で評価され、true と評価されたバリアント制御に対応する選択肢がアクティブになります。
バリアント制御は、A == 1 や A==1 && B == 2 のように、boolean の条件式の形式で指定できます。これらの式のバリアント制御変数 A および B は、MATLAB® 変数、Simulink.Parameter オブジェクト、または Simulink.VariantControl オブジェクトのいずれかにできます。詳細については、Switch Between Choices Using Condition Expressions in Variant Blocksを参照してください。
boolean のバリアント条件式を表現するには、Simulink.VariantExpression クラスのオブジェクトを作成します。ベース ワークスペースまたはデータ ディクショナリでオブジェクトを定義し、そのオブジェクトを選択肢のバリアント制御としてバリアント ブロックで使用できます。Simulink.VariantExpression オブジェクトを使用すると、一般的なバリアント条件をモデル間で再利用でき、バリアント条件式の可読性が向上します。
次の例では、Variant Source ブロックで Simulink.VariantExpression オブジェクトをバリアント制御として使用しています。
v_EngType_Big = Simulink.VariantExpression('V == 1'); v_EngType_Small = Simulink.VariantExpression('V == 2');
メモ
マスクまたはモデル ワークスペースで
Simulink.VariantExpressionオブジェクトを使用してバリアント制御を定義することはサポートされていません。バリアント制御変数の保存場所の詳細については、Storage Locations for Variant Control Variables (Operands) in Variant Blocksを参照してください。構造体内で
Simulink.VariantExpressionオブジェクトを使用することはサポートされていません。
作成
プロパティ
例
モデルのシミュレーションは行うが、コード生成は行わない場合は、MATLAB 変数を使用します。
スカラー リテラル値をもつ MATLAB 変数を作成します。
Fuel = 3; Emission = 2; Ratio = 3;
変数を使用して条件式を定義し、バリアント制御を作成します。
Variant1 = Simulink.VariantExpression('Fuel==3 && Emission==2'); Variant2 = Simulink.VariantExpression('(Fuel==2 || Emission==1) && Ratio==2'); Variant3 = Simulink.VariantExpression('Fuel==3 || Ratio==4');
コード生成用のプリプロセッサ条件を生成するには、Simulink.Parameter オブジェクトを使用します。
スカラー リテラル値をもつバリアント Simulink.Parameter オブジェクトを作成します。
Fuel = Simulink.Parameter(3); Emission = Simulink.Parameter(2); Ratio = Simulink.Parameter(3);
値が外部ヘッダー ファイルで指定されるように、これらのオブジェクトのカスタム ストレージ クラスを ImportedDefine に指定します。カスタム ストレージ クラスのその他の有効な値は Define と CompilerFlag です。
メモ
バリアントのアクティベーションのタイミングが startup に設定されたコードを生成する場合は、オブジェクトのサポートされるカスタム ストレージ クラスを指定します。startup のアクティベーションのタイミングをサポートする組み込みおよびカスタムのストレージ クラスの詳細については、Storage Classes for Different Variant Activation Timesを参照してください。
Fuel.CoderInfo.StorageClass = 'Custom'; Fuel.CoderInfo.CustomStorageClass = 'ImportedDefine'; Emission.CoderInfo.StorageClass = 'Custom'; Emission.CoderInfo.CustomStorageClass = 'ImportedDefine'; Ratio.CoderInfo.StorageClass = 'Custom'; Ratio.CoderInfo.CustomStorageClass = 'ImportedDefine';
変数を使用して条件式を定義し、バリアント制御を作成します。
Variant1 = Simulink.VariantExpression('Fuel==3 && Emission==2'); Variant2 = Simulink.VariantExpression('(Fuel==2 || Emission==1) && Ratio==2'); Variant3 = Simulink.VariantExpression('Fuel==3 || Ratio==4');
Simulink.VariantControl 型のバリアント制御変数をバリアントのアクティベーションのタイミングに関連付けることができます。例については、Simulink.VariantControl Variables for Coherent Switching of Choices in Variant Blocksを参照してください。
スカラー リテラル値をもつ Simulink.VariantControl オブジェクトを作成します。
Fuel = Simulink.VariantControl('Value',3,'ActivationTime','update diagram'); Emission = Simulink.VariantControl('Value',2,'ActivationTime','update diagram'); Ratio = Simulink.VariantControl('Value',3,'ActivationTime','update diagram');
変数を使用して条件式を定義し、バリアント制御を作成します。
Variant1 = Simulink.VariantExpression('Fuel==3 && Emission==2'); Variant2 = Simulink.VariantExpression('(Fuel==2 || Emission==1) && Ratio==2'); Variant3 = Simulink.VariantExpression('Fuel==3 || Ratio==4');
モデルに必要なバリアント値を特定した後、バリアント条件をSimulink.VariantExpressionオブジェクトとして定義して、バリアント ブロックのアクティベーションを制御する複雑なバリアント条件を作成できます。Simulink.VariantExpression オブジェクトを使用すると、一般的なバリアント条件をモデル間で再利用でき、複雑なバリアント条件式のカプセル化に役立ちます。
Simulink.VariantExpression オブジェクトの Condition プロパティ内でバリアント条件式全体を指定することも、バリアント制御変数のみを指定することもできます。
メモ:
Simulink.VariantExpression型のバリアント制御変数は、ベース ワークスペースまたはデータ ディクショナリでのみ定義できます。マスクまたはモデル ワークスペースでSimulink.VariantExpressionオブジェクトを使用してバリアント制御を定義することはサポートされていません。バリアント制御変数の保存場所の詳細については、Storage Locations for Variant Control Variables (Operands) in Variant Blocksを参照してください。構造体内で
Simulink.VariantExpressionを使用することはサポートされていません。
slexVariantSubsystems モデルを開きます。
open_system('slexVariantSubsystems');MATLAB® コマンド ウィンドウで、Simulink.VariantExpression オブジェクトのバリアント制御式を定義します。
V_LinearController = Simulink.VariantExpression('V==1'); V_NonLinearController = Simulink.VariantExpression('V==2');
Controller ブロックの [ブロック パラメーター] ダイアログ ボックスで、Simulink.VariantExpression オブジェクトをバリアント制御変数として指定します。
set_param('slexVariantSubsystems/Controller/Linear Controller', 'VariantControl', 'V_LinearController') set_param('slexVariantSubsystems/Controller/Nonlinear Controller', 'VariantControl', 'V_NonLinearController')
モデルで Controller ブロックの [ブロック パラメーター] ダイアログ ボックスを開きます。Simulink.VariantExpression オブジェクトが表す boolean 条件が [バリアントの選択肢] テーブルの [条件] 列に自動的に表示されます。
バリアント制御変数 V の値を 1 と設定し、モデルのシミュレーションを実行します。
V = 1;
sim('slexVariantSubsystems');シミュレーション時に Linear Controller ブロックがアクティブになります。Controller ブロックをダブルクリックしてアクティブな選択肢を確認します。この方法を使用して、再利用可能な複雑なバリアント条件式を開発できます。
