シミュレーションデータのエクスポート

シミュレーションデータをエクスポート (ログ作成) することにより、モデルの解析とデバッグに使用できるベースラインを提供します。標準またはカスタムの MATLAB^® 関数を使用して、シミュレーションしたシステム入力信号を生成し、システム出力のグラフ化、解析、またはその他の後処理を行うことができます。

シミュレーションデータ

シミュレーションデータには、信号、時間、出力、状態、およびデータストアログデータのあらゆる組み合わせを含めることができます。

シミュレーションデータのエクスポートには、信号値を後で解析および処理するために、シミュレーション中に MATLAB ワークスペースまたは MAT ファイルに保存することも含まれます。データのエクスポートは、データのログまたはシミュレーションデータの保存としても知られています。

データは次のようにいくつかの形式で記録できます。

Simulink.SimulationData.Dataset
構造体
時間付き構造体
時系列
配列

他の形式で記録されたデータについては、後処理が簡単になるように Dataset 形式に変換することを検討してください。詳細については、ログデータのデータセット変換を参照してください。

ログデータをモデルのシミュレーションの入力として使用することもできます。

シミュレーションデータのログ記録

次の 1 つ以上の手法を使用してシミュレーションデータをログに記録できます。

ログ手法	使用方法	ドキュメンテーション
出力のログを有効にして、信号をルートレベルの Outport ブロックに接続する	Outport ブロックが既にモデルに含まれている場合、最上位モデルにおけるデータの記録にこのアプローチの使用を検討します。	出力 Outport
信号のログを有効にして、モデル全体でログ記録対象の信号をマークする	信号のログを使用して、ブロックのモデルへの追加を回避します。 [信号プロパティ] または [計測のプロパティ] を使用して指定した個々の信号のログレートを使用して、信号をログに記録します。データを使用できるのは、シミュレーションの一時停止時、停止時、または完了時です。	信号のログ信号ログを使用して、信号データをエクスポート
信号を Record ブロックに接続する	Record ブロックを使用すると、データをワークスペース、ファイル、またはワークスペースとファイルの両方に記録できます。 Record ブロックは、MAT ファイル、Microsoft^® Excel^® ファイル、または MLDATX ファイルへのデータのログ記録をサポートしています。 Record ブロック内のログデータの可視化には、スパークラインプロット、時間プロット、XY プロットなどのいくつかの可視化を使用できます。	Record, XY Graph
信号を To Workspace ブロックに接続する	ログ記録された信号データを格納する変数の名前を指定します。基本サンプルレート以外のサンプルレートで出力を保存します。	To Workspace
信号を To File ブロックに接続する	To File ブロックは、データをワークスペースの変数に保存せずに MAT ファイルに保存します。基本サンプルレート以外のサンプルレートで出力を保存します。シミュレーションが完了した後、MAT ファイルのみ使用します。	To File
Simulink^® を時間データと状態データをエクスポートするように設定する。	シミュレーションの情報全体を取得するには、このデータのエクスポートを検討します。状態は、モデルの基本サンプルレートでログに記録されます。	時間状態 Save Block States and Simulation Operating Points 記録されたシミュレーションデータのデータ形式
データストアログを記録する	モデルの階層構造全体でデータを共有するデータストアのログを記録し、すべてのデータストア書き込みの順序を取得します。	データストアのログ記録
Scope ブロックを信号に接続します。	基本サンプルレート以外のサンプルレートで出力を保存します。 Scope がデータを格納し、メモリを大量に使用する場合があります。	Scope

シミュレーションデータエクスポートを有効にする

シミュレーション中にモデルの状態とルートレベルの出力端子をベースワークスペースにエクスポートするには、次のいずれかのインターフェイスを使用します。

[コンフィギュレーションパラメーター] ダイアログボックスを使用して、データをログに記録するように設定します。[モデル化] タブの [設定] で、[モデル設定] をクリックします。次に、[データのインポート/エクスポート] ペインを選択します。詳細については、モデルコンフィギュレーションパラメーター: Data Import/Exportを参照してください。
関数 set_param を使用して、データをログに記録するようにプログラムで設定します。
関数 sim への入力を指定して、特定のシミュレーションについてデータをログに記録するように設定します。コンフィギュレーションパラメーター値はシミュレーション中に適用され、シミュレーションの終了時に元に戻されます。

いずれの方法でも以下を指定します。

エクスポートするシミュレーションデータの種類:
- 信号のログ
- 時間
- 出力
- 状態または最終状態
- データストア
ログに記録する各種のシミュレーションデータのログ変数名。それぞれの種類のシミュレーションデータには、既定の名前をもつ関連するログ変数があります。
以下を含むシミュレーションデータのログを記録する方法:

シミュレーションデータインスペクターを使用したログデータの表示

エクスポートされたシミュレーションデータを対話形式で調査するには、シミュレーションデータインスペクターの使用を検討します。

シミュレーションデータインスペクターには、表示するログデータの種類にいくつかの制限があります。シミュレーションデータインスペクターでのデータの表示を参照してください。

メモリパフォーマンス

ログデータの最適化

ラピッドアクセラレータ以外のシミュレーションモードでシミュレーションデータをエクスポートする場合、Simulink は以下の状況でメモリ使用量を最適化します。

タイムステップが一定の間隔で発生する場合、Simulink は圧縮された時間表現を使用します。Simulink は最初のタイムスタンプの値、間隔の長さ (タイムステップ) およびタイムスタンプの合計数を保存します。
複数の信号が同じタイムスタンプシーケンスを使用する場合、信号は保存された単一のタイムスタンプシーケンスを共有します。保存された単一のタイムスタンプを共有することにより、ログデータ用のメモリ使用量が 1/2 程度に削減されます。特に、要素の数が数千のバスを記録する場合、メモリの差は、重要なパフォーマンス要因になります。

永続ストレージへのログの記録

多くのタイムステップが含まれる長いシミュレーションに大量の信号を記録する場合、メモリの問題が発生する可能性があります。永続ストレージにログを記録すると、このようなメモリの問題に対処できます。

永続ストレージにログを記録するには、[コンフィギュレーションパラメーター] 、 [データのインポート/エクスポート] ペインで、[データセットのデータをファイルにログ] オプションを選択します。ログの種類を指定します (信号のログや状態のログなど)。

出力と状態データを記録するには、[形式] パラメーターを [データセット] に設定します。
[最終状態] パラメーターを選択する場合、[最終の操作点を保存] パラメーターをオフにします。

Simulink.SimulationData.DatasetRef オブジェクトを使用して信号ログデータおよび状態ログデータにアクセスすることで、データをモデルワークスペースにインクリメンタルに読み込みます。他の種類のログのデータにアクセスすると、すべてのデータが一度に読み込まれます。

詳細については、永続ストレージへのデータの記録を参照してください。