Main Content

addConfiguration

クラス: Simulink.VariantConfigurationData
名前空間: Simulink

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

説明

メモ

このメソッドには Variant Manager for Simulink® が必要です。

vcdataObj.addConfiguration(name) は、Simulink.VariantConfigurationData クラスのオブジェクトであるバリアント コンフィギュレーション データ オブジェクト vcdataObj に、指定した名前をもつ新しいバリアント コンフィギュレーションを追加します。

vcdataObj.addConfiguration(name,description) は、バリアント コンフィギュレーション データ オブジェクトに、指定した名前とオプションの説明をもつ新しいバリアント コンフィギュレーションを追加します。

vcdataObj.addConfiguration(name,description,controlVars) は、バリアント コンフィギュレーション データ オブジェクトに、指定した名前、オプションの説明、および制御変数をもつ新しいバリアント コンフィギュレーションを追加します。

入力引数

すべて展開する

バリアント コンフィギュレーション データ オブジェクトに追加する新しいバリアント コンフィギュレーションの名前。文字ベクトルまたは string として指定します。

例: 'LinInterExpNoNoise'

データ型: char | string

バリアント コンフィギュレーションの説明。文字ベクトルまたは string として指定します。

例: 'Linear configuration with internal plant'

データ型: char | string

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

  • Name — 制御変数の名前。文字ベクトルとして指定します。

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

    • 通常の MATLAB® 変数

    • Simulink.Parameter

    • 通常の MATLAB 変数としての値をもつ Simulink.VariantControl

    • Simulink.Parameter としての値をもつ Simulink.VariantControl

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

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

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

データ型: struct

すべて展開する

この例では、バリアント コンフィギュレーション データ オブジェクトに新しいバリアント コンフィギュレーションを追加する方法を示します。

空の Simulink.VariantConfigurationData オブジェクトを作成します。

vardataObj = Simulink.VariantConfigurationData
vardataObj = 
  VariantConfigurationData with properties:

            Configurations: [1x0 struct]
               Constraints: [1x0 struct]
    PreferredConfiguration: ''

新しいコンフィギュレーションの制御変数の名前と値を含む struct を作成します。

% Define a variant control variable
PlantLoc = Simulink.VariantControl('Value', 1, 'ActivationTime', 'code compile');
% Create a variant control variable structure
ctrlVarStruct = struct(Name='PlantLoc', Value=PlantLoc, Source='topdata.sldd')
ctrlVarStruct = struct with fields:
      Name: 'PlantLoc'
     Value: [1x1 Simulink.VariantControl]
    Source: 'topdata.sldd'

新しいコンフィギュレーションを vardataObj に追加します。

vardataObj.addConfiguration('LinInterExpNoNoise', 'Linear Internal Experimental Plant Controller', ctrlVarStruct)

バージョン履歴

R2013b で導入