Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

Simulink.SimulationData.updateDatasetFormatLogging

信号のログに Dataset 形式を使用するよう、モデルおよびその参照モデルを変換する

構文

Simulink.SimulationData.updateDatasetFormatLogging(top_model)
Simulink.SimulationData.updateDatasetFormatLogging(top_model, variants)

説明

メモ

ModelDataLogs クラスは、下位互換のためにサポートされています。R2016a 以降は、データを [ModelDataLogs] 形式で記録することはできません。信号ログでは、[データセット] 形式が使用されます。R2016a 以降では、ModelDataLogs 形式を使用していた前のリリースのモデルを開くと、そのモデルが Dataset 形式を使用するようにシミュレートされます。このコマンドを使用して、モデル参照を使用するモデルの信号ログ形式を更新する必要はありません。R2016a 以降でモデルを開くと、すべての信号ログに Dataset 形式が使用されます。

ModelDataLogs の信号ログ データは Dataset 形式に変換できます。Dataset 形式に変換すると、同様に Dataset 形式を使用できる他の記録されたデータ (記録された状態など) との事後処理が容易になります。詳細については、Dataset 形式へのログ データの変換を参照してください。

ModelDataLogs API を使用するレガシ コードがある場合、コードまたはモデルに対する更新が必要な状況が生じる可能性があります。レガシ ModelDataLogs API を使用するスクリプトの移行を参照してください。

Simulink.SimulationData.updateDatasetFormatLogging(top_model) は、ModelDataLogs 形式の代わりに Dataset 形式を使用した信号のログをするよう、最上位モデルおよびすべての参照モデルを変換します。ModelDataLogs の信号ログ データは Dataset 形式に変換できます。Dataset 形式に変換すると、同様に Dataset 形式を使用できる他の記録されたデータ (記録された状態など) との事後処理が容易になります。詳細については、Dataset 形式へのログ データの変換を参照してください。

Model ブロックで [プリプロセッサの条件を生成] オプションがオンにされている場合、すべてのバリアントが変換されますが、そうでない場合はアクティブ バリアントだけが変換されます。

Simulink.SimulationData.updateDatasetFormatLogging(top_model, variants) は、Dataset 形式による信号のログを使用するために、どのバリアント モデルを変換するかを指定します。variants 引数の詳細は、入力引数を参照してください。

入力引数

top_model

最上位モデルの名前を指定する文字ベクトル。

variants

更新するバリアント モデルを指定する文字ベクトル。

  • 'ActivePlusCodeVariants' — (既定の設定) プリプロセッサの条件が生成される場合、すべてのバリアントを検索します。そうでない場合は、アクティブなバリアントのみを検索します。

  • 'ActiveVariants' — アクティブなバリアントのみを変換します。

  • 'AllVariants' — すべてのバリアントを変換します。

詳細

すべて折りたたむ

データセット

Dataset 形式を使用した場合、Simulink® は、Simulink.SimulationData.Dataset オブジェクトを使用してログ信号データを格納します。Dataset 形式は、データの書式設定に MATLAB®timeseries オブジェクトを使用します。

ModelDataLogs

ModelDataLogs 形式を使用した場合、Simulink は、Simulink.ModelDataLogs オブジェクトを使用してログ信号データを格納します。Simulink.Timeseries および Simulink.TsArray オブジェクトはデータの形式を提供します。

ヒント

  • 変換関数は、更新されたすべてのモデルについて、SignalLoggingSaveFormat パラメーター値を Dataset に設定します。

  • 変換関数による形式の更新を保存する場合は、最上位モデル、参照モデル、およびバリアント モデルが、アクセスおよび書き換え可能であることを確認してください。

  • その他に未保存の変更がないモデルの場合、変換関数はそのモデルの形式の更新を保存します。未保存の変更があるモデルの場合、関数による形式の更新は行われますが、これらの変更は保存されません。

  • 参照モデルを含まないモデルにこの関数を適用すると、最上位モデルを Dataset 形式を使用するように変換します。

R2011a で導入