Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

Simulink.VariantConfigurationData クラス

名前空間: Simulink

プログラムによるバリアント コンフィギュレーションの作成

説明

メモ

このクラスには Variant Manager for Simulink® が必要です。

Simulink.VariantConfigurationData クラスは、バリアント コンフィギュレーション、制約、およびモデルに対する推奨されるバリアント コンフィギュレーションの名前の集合を格納するバリアント コンフィギュレーション データ オブジェクトを作成するために使用します。このオブジェクトはベース ワークスペースまたはデータ ディクショナリの [コンフィギュレーション] セクションで定義できます。このクラスには、次のことを実行できるメソッドがあります。

  • 新しいバリアント コンフィギュレーションを定義する。

  • バリアント コンフィギュレーションにバリアント制御変数を追加する。

  • バリアント コンフィギュレーションのコピーを作成する。

  • 無効なバリアント コンフィギュレーションをチェックするための制約を定義する。

  • 既存のバリアント コンフィギュレーション、制約、制御変数を削除する。

  • 特定のコンフィギュレーションを推奨されるバリアント コンフィギュレーションとして設定する。

作成

説明

varconfigdataObj = Simulink.VariantConfigurationData は、空のバリアント コンフィギュレーション データ オブジェクトを作成します。

varconfigdataObj = Simulink.VariantConfigurationData(Name=Value) は、バリアント コンフィギュレーション データ オブジェクトを作成し、1 つ以上の名前と値の引数を使用してプロパティを設定します。

プロパティ

すべて展開する

バリアント コンフィギュレーション データ オブジェクト内のバリアント コンフィギュレーションのセット。次のフィールドをもつ構造体配列として指定します。

フィールド説明
Name文字ベクトルまたは string スカラー

コンフィギュレーションの名前。この値は、一意の有効な MATLAB® 変数名でなければなりません。

Description文字ベクトルまたは string スカラー

コンフィギュレーションの説明

ControlVariables

構造体または構造体配列

バリアント制御変数の名前とその値。次のフィールドをもつ構造体または構造体配列として指定します。

  • Name — 制御変数の名前。文字ベクトルまたは string スカラーとして指定します。

  • Value — 制御変数の値。次のデータ型のいずれかとして指定します。

    • 通常の MATLAB 変数

    • Simulink.Parameter

    • Value が通常の MATLAB 変数である Simulink.VariantControl

    • ValueSimulink.Parameter である Simulink.VariantControl

  • Source — 制御変数のソース。文字ベクトルとして指定します。ソースは 'base workspace' またはデータ ディクショナリの名前でなければなりません。

例: ctrlVarStruct=struct(Name='ControllerType.Linear',Value='NoiseType.NoNoise',Source='plant.sldd');

各種のバリアント制御変数の使用方法を示す例については、Use Variant Control Variables in Variant Blocksを参照してください。

属性:

GetAccess
public
SetAccess
private

データ型: struct

バリアント コンフィギュレーション データ オブジェクト内のすべてのバリアント コンフィギュレーションが満たさなければならない制約。次のフィールドをもつ構造体配列として指定します。

  • Name — 制約の名前。文字ベクトルまたは string スカラーとして指定します。この値は、一意の有効な MATLAB 変数名でなければなりません。

  • Condition — バリアント制御変数を使用して定義された boolean 式。文字ベクトルまたは string スカラーとして指定します。制約が満たされるには、この式が true に評価される必要があります。

  • Description — 制約の説明。文字ベクトルまたは string スカラーとして指定します。

属性:

GetAccess
public
SetAccess
private

データ型: struct

推奨されるバリアント コンフィギュレーションの名前。文字ベクトルまたは string スカラーとして指定します。このプロパティは、一般的なワークフロー向けのモデルに適したコンフィギュレーションを示すために使用します。この値は、バリアント コンフィギュレーション データ オブジェクトにあるバリアント コンフィギュレーションの名前でなければなりません。

属性:

GetAccess
public
SetAccess
public

データ型: char | string

メソッド

すべて展開する

すべて折りたたむ

この例では、Simulink.VariantConfigurationData クラスのインスタンスを作成し、次のクラス プロパティを設定する方法を示します。

  • Configurations (struct)

  • Constraints (struct)

  • PreferredConfiguration (char)

新しいバリアント コンフィギュレーションの定義

バリアント コンフィギュレーション データ オブジェクトに追加する新しいバリアント コンフィギュレーションを定義します。

Simulink.VariantConfigurationData クラスの VariantConfigurations プロパティには次のフィールドがあります。

  • Name (char)

  • ControlVariables (struct)

  • Description (char)

  • 新しいコンフィギュレーションのバリアント制御変数と値を格納する ControlVariables フィールド用の struct を作成します。

ctrlVarStruct = struct(Name='ControllerType.Linear',Value='NoiseType.NoNoise',Source='plant.sldd');
  • 新しいバリアント コンフィギュレーション用の struct を作成します。

configStruct = struct(Name='LinInterExpNoNoise',ControlVariables=ctrlVarStruct, ...
 Description='Linear Internal Experimental Plant Controller');

制約の定義

バリアント コンフィギュレーション データ オブジェクト内のすべてのバリアント コンフィギュレーションに適用される制約を定義します。

constrStruct = struct(Name='PlantLocation',Condition= ...
'(PlantLoc==PlantLocation.Internal) || (PlantLoc==PlantLocation.External)', ...
Description='Plant location constraint');

バリアント コンフィギュレーション データ オブジェクトの作成

バリアント コンフィギュレーション、グローバル制約、および推奨されるコンフィギュレーションの名前を追加してオブジェクトを作成します。

 vcdo = Simulink.VariantConfigurationData(Configurations=configStruct,Constraints=constrStruct, ...
 PreferredConfiguration='LinInterExpNoNoise')
vcdo = 
  VariantConfigurationData with properties:

            Configurations: [1x1 struct]
               Constraints: [1x1 struct]
    PreferredConfiguration: 'LinInterExpNoNoise'

モデルとのバリアント コンフィギュレーション データ オブジェクトの関連付けまたは関連付け解除

VariantConfigurationObject モデル パラメーターを使用して vcdo を Simulink® モデルに関連付けることができます。

set_param('model','VariantConfigurationObject','vcdo');

モデルと vcdo の関連付けを解除するには、VariantConfigurationObject モデル パラメーターを空の文字ベクトルまたは string に設定します。

set_param('model','VariantConfigurationObject','');

モデルを保存することで変更を保存します。

 save_system('model');

ヒント

バリアント構成オブジェクトは、バリアント マネージャーを起動せずにベース ワークスペースまたはデータ ディクショナリから編集できます。モデル エクスプローラーで、ベース ワークスペースまたはデータ ディクショナリの [コンフィギュレーション] セクションにあるオブジェクトをダブルクリックします。この操作により、Simulink.VariantConfigurationData のプロパティ ダイアログ ボックスが起動します。スタンドアロンのバリアント マネージャーとして機能するこのダイアログ ボックスで、バリアント構成オブジェクトのバリアント コンフィギュレーション、制御変数、制約を変更できます。

バージョン履歴

R2013b で導入

すべて展開する