Main Content

slTunerOptions

slTuner のインターフェイス オプションを設定

説明

options = slTunerOptions は、slTuner インターフェイスの既定のオプション セットを返します。

options = slTunerOptions(Name,Value) は、1 つ以上の Name,Value の引数ペアで指定された追加オプションを使用して、オプション セットを返します。

すべて折りたたむ

レート変換法を周波数 10 rad/s のプリワーピング付き Tustin 法に設定する、slTuner インターフェイスのオプション セットを作成します。

options = slTunerOptions('RateConversionMethod','prewarp',...
                           'PreWarpFreq',10);

あるいは、ドット表記を使用して options の値を設定します。

options = slTunerOptions;
options.RateConversionMethod = 'prewarp';
options.PreWarpFreq = 10;

入力引数

すべて折りたたむ

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後に表示されなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、名前と値をそれぞれコンマを使って区切り、Name を引用符で囲みます。

例: 'RateConversionMethod','prewarp' は、レート変換メソッドをプリワーピング付き Tustin メソッドに設定します。

線形化サンプル時間。'SampleTime' と、次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • 0 — 連続時間モデルを作成します。

  • 正のスカラー — 離散時間システムのサンプル時間を指定します。

線形化されたモデル内の I/O および状態の名前を打ち切るかどうかを示すフラグ。'UseFullBlockNameLabels' と次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'off' — 線形化されたモデル内の I/O および状態に、打ち切られた名前を使用します。

  • 'on' — 線形化されたモデル内の I/O および状態の名前に、ブロックの絶対パスを使用します。

線形化されたモデル内で I/O のラベル付けにバス信号チャネルの番号または名前のどちらを使用するかを示すフラグ。'UseBusSignalLabels' と次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'off' — バス信号チャネル番号を使用して、線形化されたモデルのバス信号の I/O にラベルが付けられます。

  • 'on' — バス信号名を使用して、線形化されたモデルのバス信号の I/O にラベルが付けられます。I/O ポイントが次に示すブロックの出力ポイントに位置している場合、バス信号名が結果に表示されます。

    • バス オブジェクトを含んでいる、ルートレベルの Inport ブロック

    • Bus Creator ブロック

    • ソースが Bus Creator ブロックの出力まで遡って追跡するサブシステム ブロック

    • ソースがバーチャルまたは非バーチャル サブシステムの境界のみのパス スルーにより、ルートレベルの Inport まで遡って追跡するサブシステム ブロック

入力、出力、状態、および状態微分または更新された状態について、線形化のオフセットを計算するかどうかを示すフラグ。'StoreOffsets' と次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • false — 線形化オフセットを計算しません。

  • true — 線形化オフセットを計算します。

線形化オフセットを使用して LPV System ブロックを構成できます。例については、LTI システムの配列を使用した非線形動作の近似を参照してください。

線形化中に診断情報を保存するかどうかを示すフラグ。'StoreAdvisor' と次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • false — 線形化の診断情報を保存しません。

  • true — 線形化の診断情報を保存します。

線形化コマンドは診断情報を保存して LinearizationAdvisor オブジェクトに返します。LinearizationAdvisor オブジェクトを使用して線形化の結果をトラブルシューティングする例は、コマンド ラインを使用した線形化の結果のトラブルシューティングを参照してください。

マルチレート システムの線形化でレート変換に使用されるメソッド。'RateConversionMethod' と次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'zoh' — ゼロ次ホールド レート変換メソッド

  • 'tustin' — Tustin (双一次) メソッド

  • 'prewarp' — 周波数プリワーピングを伴う Tustin メソッド。このメソッドを使用する場合、PreWarpFreq オプションを目的のプリワープ周波数に設定します。

  • 'upsampling_zoh' — 可能であれば離散状態をアップサンプルし、不可の場合は 'zoh' を使用します。

  • 'upsampling_tustin' — 可能であれば離散状態をアップサンプルし、不可の場合は 'tustin' を使用します。

  • 'upsampling_prewarp' — 可能であれば離散状態をアップサンプルし、不可の場合は 'prewarp' を使用します。このメソッドを使用する場合、PreWarpFreq オプションを目的のプリワープ周波数に設定します。

マルチレート モデルのレート変換と線形化の詳細については、以下を参照してください。

メモ

'zoh' 以外のレート変換メソッドを使用する場合、変換後の状態は、元の状態と異なる物理的意味をもちます。そのため、結果の LTI システムで状態名が '?' に変更されます。

プリワープ周波数 (rad/s 単位)。'PreWarpFreq' と非負のスカラーで構成されるコンマ区切りのペアとして指定します。このオプションは RateConversionMethod'prewarp' または 'upsampling_prewarp' の場合にのみ適用されます。

線形化のためにパラメーター値を変化させる際、モデルを再コンパイルするかどうかを示すフラグ。'AreParamsTunable' と次のいずれかで構成されるコンマ区切りのペアとして指定します。

  • true — 変化するパラメーターがすべて調整可能な場合はモデルを再コンパイルしません。変化するパラメーターのいずれかが調整可能でない場合、それぞれのパラメーター グリッド点でモデルを再コンパイルして、警告メッセージを表示します。

  • false — それぞれのパラメーター グリッド点でモデルを再コンパイルします。調整不可能なパラメーターの値を変化させる場合、このオプションを使用してください。

線形化でパラメーターが変化する場合のモデルのコンパイルの詳細については、パラメーター値を変化させたときのバッチ線形化の効率性を参照してください。

出力引数

すべて折りたたむ

slTuner インターフェイスのオプション。slTunerOptions オプション セットとして返されます。

バージョン履歴

R2014a で導入

参考