状態

シミュレーション中にブロックの状態値を記録するオプション

モデル コンフィギュレーション ペイン: データのインポート/エクスポート

説明

ブロックの状態値を指定の MATLAB® 変数に記録するかどうかを指定します。一部のブロックにある隠れ状態のデータは状態ログで取得されません。

既定では、シミュレーション結果は単一の Simulink.SimulationOutput オブジェクトとして返されます。記録する状態データに指定したログ変数は SimulationOutput オブジェクトのプロパティになります。記録された状態データにアクセスするには、ドット表記を使用します。たとえば、既定の出力変数名 out と既定の状態ログ変数名 xout を使用するときは、次のコードを使用して状態データにアクセスします。

xout = out.xout;

設定

off (既定値) | on
off

シミュレーション中にブロックの状態を記録しません。

on

シミュレーション中にブロックの状態値を記録します。既定では、状態データは変数名 xout を使用して保存されます。別の変数名を使用するには、テキスト ボックスで有効な MATLAB 変数名を指定します。

変数の名前は、Simulink.SimulationOutput オブジェクトのいずれのオブジェクト関数またはプロパティの名前とも一致してはなりません。

状態データの詳細については、Save Block States and Simulation Operating Pointsを参照してください。

ヒント

  • ログに記録される状態データの形式を、[形式] パラメーターで指定します。

  • 固定小数点の状態データのログを記録するには、[データセット] 形式で状態データのログを記録します。

  • [データセット] 形式を使用して状態データのログを記録すると、シミュレーション中に状態データがシミュレーション データ インスペクターにストリーミングされます。

  • [データセット] 形式では以下はサポートされません。

    • ラピッド アクセラレータ シミュレーション中の状態の記録

    • Function-Call Subsystem 内の状態の記録

    • Simulink® Compiler™ を使用して展開されたシミュレーションでの状態の記録

    • コード生成

  • 状態を持たないモデルについて状態ログを有効にした場合、状態ログ変数は空になります。

  • [時間付き構造体] 形式で、または時間のログも取りながら [配列] 形式で状態データのログを記録する場合、[ワークスペース データのログをシミュレーション データ インスペクターに記録] パラメーターをオンにして、シミュレーション後にデータをシミュレーション データ インスペクターで表示します。

推奨設定

次の表は、このパラメーターの推奨値をコード生成に関連する考慮事項に基づいてまとめたものです。

アプリケーション設定
デバッグ影響なし
トレーサビリティ影響なし
効率性推奨なし
安全対策推奨なし

プログラムでの使用

パラメーター: SaveState
値: 'on' | 'off'
既定の設定: 'off'
パラメーター: StateSaveName
型: string | 文字ベクトル
値: 有効な MATLAB 変数名
既定の設定: 'xout'

バージョン履歴

R2006a より前に導入

参考

モデル設定

オブジェクト

トピック