データログ

後続のデータ処理のためにモデルのシミュレーション中にワークスペースにデータログを作成

シミュレーションデータのログをワークスペースまたはディスク上の一時ファイルに記録し、デバッグと検証に使用できます。データログにより、シミュレーション中の時間経過に伴い内部ブロックの変数がどのように変化するかを解析できます。シミュレーションデータのログを記録すると、後ほどシミュレーションを再実行せずにこのデータのクエリ、プロット、解析が行えます。Simscape™ データログおよび選択的なログインストルメンテーションを使用して、ブロック変数データのログを作成できます。

Simscape データログでは、モデル内の選択したブロックまたはすべてのブロックに関するすべての変数のログが作成され、そのデータがシミュレーションログワークスペース変数に出力されます。Simscape データログの作成結果は、Simscape 結果エクスプローラーツールを使用して対話的に可視化およびナビゲートできます。データログと Simscape 結果エクスプローラーを使用すると、モデルにセンサーやスコープを追加しなくてもシミュレーション結果を表示できます。詳細については、シミュレーションデータのログ作成、ナビゲートおよびプロットを参照してください。

選択的なログでは、ログが有効なブロックで選択した変数のログのみが作成されます。Simscape は、変数のログを Simulink^® 信号と共に Simulink.SimulationData.Dataset オブジェクトに記録します。選択的なログは、ユーザーインターフェイスを使用して Simscape ブロックに対して有効にできます。ログを作成するブロック変数は、モデルをコンパイルせずにインストルメンテーションテーブルで表示および選択できます。選択的なログの作成結果を可視化するには、シミュレーションデータインスペクターを使用します。詳細については、Log Selected Block Variablesを参照してください。

選択的なログインストルメンテーションはプログラムでも管理できます。詳細については、Log Selected Variables Programmaticallyを参照してください。

ツール

Simscape 結果エクスプローラー

Navigate and plot simulation data logging results

関数

すべて展開する

Simscape データログオブジェクト

`simscape.logging.Node`	Hierarchy tree for simulation data
`simscape.logging.Series`	Time-value series for simulation data

Simscape データログ関数

`simscape.logging.export`	Save logged simulation data in MLDATX file
`simscape.logging.import`	Create simulation log variable to access data in MLDATX file
`simscape.logging.plot`	Plot logged simulation data for Node or Series
`simscape.logging.plotxy`	Plot logged simulation data for one node or series against another
`simscape.logging.findNode`	Find `Node` object corresponding to block or subsystem (R2020a 以降)
`simscape.logging.sli.findNode`	(To be removed) Find `Node` object corresponding to block or subsystem
`simscape.logging.findPath`	Find path to node in logged simulation data tree (R2020a 以降)
`simscape.logging.sli.findPath`	(To be removed) Find path to node in logged simulation data tree
`simscape.logging.getSimulationLog`	Identify latest Simscape simulation log for a model (R2024a 以降)
`simscape.logging.timestamp`	Determine whether simulation log is current or stale (R2021a 以降)
`sscexplore`	Open Simscape Results Explorer to interact with logged simulation data
`sscprintzcs`	Print zero crossing information for logged simulation data

選択的なログオブジェクト

`simscape.instrumentation.VariableTable`	Store and manage block variable data (R2024a 以降)
`simscape.instrumentation.VariableConfiguration`	Configuration for variable (R2024a 以降)

選択的なログ関数

`simscape.instrumentation.defaultVariableTable`	Return default VariableTable object for block (R2024a 以降)
`simscape.instrumentation.setVariableTable`	Set the VariableTable object for a block (R2024a 以降)
`simscape.instrumentation.getVariableTable`	Get current VariableTable object for block (R2024a 以降)
`simscape.instrumentation.enableLogging`
`simscape.instrumentation.disableLogging`
`simscape.instrumentation.isLoggingEnabled`	Return whether block variables have logging enabled (R2024a 以降)

トピック

Simscape データログ

About Simscape Data Logging
You can log Simscape simulation data to the workspace, or to a temporary file on disk, for debugging and verification.
モデル全体の Simscape データログの有効化
モデル全体のデータログを使用することはベストプラクティスです。
選択したブロックのみのデータのログ作成
モデル全体の Simscape シミュレーションデータのログをとる代わりに、選択したブロックのみのログをとることができます。
データログ作成のオプション
シミュレーションデータのログ記録および表示の追加オプション。
ログデータのディスクへのストリーミング
シミュレーションデータをログに記録する場合、データをディスク上の一時ファイルにストリーミングして、ワークスペース変数でその一時ファイルをポイントすることができます。
ログに記録されたシミュレーションデータの保存と取得
ログに記録されたシミュレーションデータを将来使用するために保存し、後で取得する方法。
シミュレーションデータのログ作成、ナビゲートおよびプロット
この例では、モデル全体に対してシミュレーションデータのログを作成し、次にSimscape 結果エクスプローラーを使用してログデータのナビゲートとプロットを行うための基本ワークフローを示しています。
シミュレーションデータのログ作成とプロット
この例では、センサーをモデルに追加する代わりにシミュレーションデータのログを作成し、このデータをプロットする方法を示します。
シミュレーション統計のログ作成
この例では、シミュレーションにおけるゼロクロッシングに関する情報にアクセスして解析する方法を示します。
選択したブロックでのシミュレーションデータのログ作成と表示
この例では、モデルを設定して、選択したブロックのみについてシミュレーションデータのログを作成するようにする方法と、Simscape 結果エクスプローラーを使用してシミュレーションデータを表示する方法について示します。
シミュレーションデータをさまざまな単位でプロット
ログ記録されたシミュレーションデータを Simscape 結果エクスプローラーに表示すると、y 軸の単位をプロット内で直接変更できます。
シミュレーションデータのプロットでのカスタム単位の使用
この例では、ログ記録されたシミュレーションデータをカスタム単位表示に変更する方法を説明します。
コンポーネント配列のインデックス付け
コマンドラインインターフェイスを使用してコンポーネントの配列にインデックスを付け、たとえば、特定の配列メンバーの操作点ターゲットを取得または設定したり、シミュレーションデータをプロットするなどができます。

選択的なログ

About Selective Logging
You can output data for selected Simscape block variables along with Simulink variables and signals.
Log Selected Block Variables
Log data for an individual block variable.
Log Selected Variables Programmatically
Programmatically configure selective logging.