convertToDataset

(削除済み) ModelDataLogs 形式を使用してログ記録されたデータを Dataset 形式に変換

convertToDataset 関数は削除されました。ModelDataLogs 形式のサポートは削除されました。代わりに、Dataset など、サポートされる別の形式を使用してください。詳細については、バージョン履歴を参照してください。

構文

ds = convertToDataset(mdlObj,dsName)

説明

ds = convertToDataset(mdlObj,dsName) は、Simulink.ModelDataLogs オブジェクト mdlObj のデータを dsName で指定された名前の Simulink.SimulationData.Dataset に変換します。出力 ds は、mdlObj 内の Simulink.Timeseries、Simulink.ModelDataLogs、Simulink.TSArray、および Simulink.SubsysDataLogs の各オブジェクトの要素がフラット リストとして格納された Dataset オブジェクトです。

ModelDataLogs 形式から Dataset 形式へのデータの変換には、関数 Simulink.SimulationData.Dataset も使用できます。

入力引数

mdlObj — 変換するデータ

Simulink.ModelDataLogs オブジェクト

変換するデータ。Simulink.ModelDataLogs オブジェクトとして指定します。

dsName — 変換後のデータを格納する Dataset オブジェクトの名前

文字ベクトル

変換後のデータを格納する Dataset オブジェクトの名前。文字ベクトルとして指定します。

出力引数

ds — 変換後のデータ

Simulink.Simulationdata.Dataset オブジェクト

変換後のデータ。Simulink.Simulationdata.Dataset オブジェクトとして返されます。

制限

Simulink.ModelDataLogs データのソース	変換の制限
モデル参照	モデル参照の先祖に MATLAB® パス上に存在しないものがあると、変換に失敗します。 モデル参照やモデル参照のいずれかの先祖が Simulink.ModelDataLogs オブジェクトの作成後に変更されていると、変換に失敗することがあります。たとえば、オブジェクトの作成後にブロックの追加、削除、名前変更を行うと、変換に失敗する可能性があります。
バリアント モデルまたはサブシステム	現在のアクティブなバリアントが Simulink.ModelDataLogs オブジェクトの作成時点のアクティブなバリアントと同じでないと、変換に失敗します。
フレーム信号	サポートなし。
Mux ブロック	[データセット] 形式を使用して出力をログ記録する場合とは異なる Dataset オブジェクトが変換で生成されます。
Stateflow® チャート	サポートなし。

バージョン履歴

R2011a で導入

R2025a: 削除済み

ModelDataLogs 形式で格納されたデータはサポートされなくなりました。これには、Simulink.ModelDataLogs、Simulink.Timeseries、Simulink.TSArray、Simulink.SubsysDataLogs の各オブジェクトに格納されたデータが含まれます。

R2024b: 削除済み

convertToDataset 関数は削除されました。ModelDataLogs 形式で記録されたデータを Dataset 形式に変換するには、R2024b リリースより前のバージョンの Simulink を使用してください。

R2022b: ModelDataLogs 形式で保存されたデータの読み込みのサポート終了

R2022b 以降、ModelDataLogs 形式で格納されたデータは読み込めなくなります。これには、Simulink.Timeseries、Simulink.TSArray、Simulink.SubsysDataLogs の各オブジェクトに格納されたデータが含まれます。

ログ記録に ModelDataLogs 形式を使用する R2016a より前のリリースで作成されたモデルをシミュレートするスクリプトについては、ModelDataLogs 形式で格納されたデータを Dataset 形式に変換できます。

ModelDataLogs 形式を使用するモデルを Dataset 形式を使用するモデルに変換する場合、既存モデルや、コールバック、関数、スクリプトまたはテストのコードに変更を加えなければならない場合があります。以下の表は、Dataset 形式への変換後に発生する可能性がある問題を示しています。

予想される Dataset 形式への変換後の問題	解決法
ModelDataLogs のプログラム インターフェイスによりデータにアクセスしていた既存のコールバック、関数、スクリプトまたはテストのコードが、エラー終了する場合がある。	ModelDataLogs 形式のアクセス メソッドを使用するコードがあるかどうかをチェックします。そのコードを、Dataset 形式のアクセス メソッドを使用するように更新します。 たとえば、既存のコードに以下の行が含まれるとします。 logsout.('Subsystem Name').X.data このコードを Dataset アクセス関数に置き換えます。 get(logsout,"x").Values.data
Mux ブロック信号名が失われる。	Dataset 形式では、Mux ブロック信号をベクトルとして処理します。信号名で信号を特定するには、Mux ブロックを Bus Creator ブロックに置き換えます。
信号ログに信号ビューアーを使用できない。	信号ログ データは信号ビューアーに記録されません。 信号のログ出力変数を使用してログ データを表示します。
関数 unpack でエラーが生成される。	関数 unpack は、Simulink.ModelDataLogs および Simulink.SubsysDataLogs オブジェクトではサポートされていますが、Simulink.SimulationData.Dataset オブジェクトではサポートされて "いません"。 たとえば、mlog のデータに、x、y および z の 3 つのフィールドがあるとします。 ModelDataLogs 形式データの場合、関数 mlog.unpack がベース ワークスペースに 3 つの変数を作成します。 Dataset 形式データの場合、関数 get が名前でデータにアクセスします。 x = get(logsout,"x").Values
ModelDataLogs 形式と Dataset 形式で、名前のない信号に対する命名規則が異なる。	必要に応じて、信号名を追加します。 ModelDataLogs 形式では、ブロックから出力される名前のない信号に対し、SL_BlockName+<portIndex> という形式の名前 (SL_Gain1 など) が割り当てられます。 Dataset 形式では、要素に名前は不要であるため、信号名は空のままになります。 ModelDataLogs 形式と Dataset 形式の両方について、Bus Selector ブロックから出力された名前のない信号に同じ名前が割り当てられます。
参照モデル内のテスト ポイントがログに記録されない。	参照モデル内のテスト ポイントに対して信号ログの有効化を検討します。
スクリプトは関数 who または関数 whos を使用します。	代わりに find の使用を検討してください。

R2021a: ModelDataLogs 形式で保存されたデータの読み込みのサポート終了を予定

ModelDataLogs 形式を使用したデータをシミュレーションの入力として読み込むと、ModelDataLogs 形式のデータの読み込みに対するサポートは将来のリリースで削除される予定であることを示す警告がソフトウェアから発行されます。

R2020b: ModelDataLogs 形式で保存されたデータの読み込みのサポート終了を予定

ModelDataLogs 形式を使用したデータをシミュレーションの入力として読み込む機能は、将来のリリースで削除される予定です。

R2016a: ModelDataLogs 形式を使用したデータのログ記録のサポート終了

R2016a 以降、ModelDataLogs 形式を使用してデータをログ記録することはできなくなります。信号のログには常に [データセット] 形式が使用されます。ModelDataLogs 形式を使用してデータをログ記録していた以前のリリースのモデルを開くと、代わりに [データセット] 形式を使用してデータをログ記録するようにモデル コンフィギュレーション パラメーターが更新されます。

Simulink.SubsysDataLogs、Simulink.TSArray、Simulink.Timeseries の各オブジェクトのデータなど、以前のリリースで ModelDataLogs 形式を使用してログ記録されたデータは引き続きアクセスして使用できます。ModelDataLogs 形式で保存されたデータを [データセット] 形式に変換することも可能で、この形式に変換するとデータ処理が簡単になります。

参考

オブジェクト

• Simulink.SimulationOutput | Simulink.SimulationData.Dataset