Simulink.SubsysDataLogs

(削除済み) サブシステム内でログ記録された信号のデータにアクセス

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

説明

Simulink.SubsysDataLogs オブジェクトには、サブシステム内でログ記録されたそれぞれの信号、mux、およびバスのデータが格納されます。

作成

R2016a より前までは、[ModelDataLogs] 形式を使用してデータをログ記録するようにモデルを構成できました。[信号のログ形式] パラメーターが [ModelDataLogs] に設定されたモデルをシミュレートすると、すべてのログ信号のデータを格納する Simulink.ModelDataLogs オブジェクトが作成されていました。[ModelDataLogs] オブジェクトの名前は [信号のログ名] パラメーターを使用して指定できました。

ModelDataLogs オブジェクトに、モデル内のログ データを含む各サブシステムの Simulink.SubsysDataLogs オブジェクトが含まれています。

プロパティ

ログ データのプロパティ

Simulink.SubsysDataLogs オブジェクトには、オブジェクトが表すサブシステム内でログ記録された信号データについてのプロパティが格納されます。ログ データを格納するプロパティの数、タイプ、および名前は、サブシステムの内容とログの構成で決まります。

プロパティ名のソース	ログ データのソース	値
モデル名	最上位モデルまたはモデル参照	Simulink.ModelDataLogs
サブシステム名	サブシステム	Simulink.SubsysDataLogs
信号名	信号	Simulink.Timeseries
mux またはバーチャル バス名	mux またはバーチャル バス	Simulink.TSArray
バス オブジェクト	非バーチャル バス	Simulink.TSArray

サブシステムのプロパティ

Name — オブジェクトで表されるサブシステムの名前

文字ベクトル

オブジェクトで表されるサブシステムの名前。文字ベクトルとして指定します。

オブジェクト関数

unpack	(Removed) Extract signal data from ModelDataLogs, SubsysDataLogs, or TSArray object into workspace variables
who	(Removed) List names of objects inside ModelDataLogs, SubsysDataLogs, or TSArray object
whos	(Removed) List name and type of objects inside ModelDataLogs, SubsysDataLogs, or TSArray object

バージョン履歴

R2006a より前に導入

R2025a: 削除済み

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

R2024b: 削除予定

Simulink.SubsysDataLogs オブジェクトは将来のリリースで削除される予定です。

R2024b: ModelDataLogs 形式で記録されたデータの Dataset 形式への変換のサポート終了

convertToDataset 関数が削除され、Simulink.SimulationData.Dataset オブジェクトで ModelDataLogs 形式を Dataset 形式に変換することはできなくなりました。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