Simulink.Timeseries

(削除済み) ログ記録された信号データにアクセス

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

説明

Simulink.Timeseries オブジェクトには、シミュレーションでログ記録された信号のデータがメタデータと共に格納されます。mux またはバスのログ データは、各要素の Simulink.Timeseries オブジェクトを含む Simulink.TSArray オブジェクトとして格納されます。

作成

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

Simulink.ModelDataLogs オブジェクトの構造にはモデルの構造が反映されます。

• 1 つ以上の Simulink.Timeseries オブジェクトに、ModelDataLogs オブジェクトが表すモデルでログ記録された 1 つ以上の信号のデータが格納されます。

• 1 つ以上の Simulink.TSArray オブジェクトに、ModelDataLogs オブジェクトが表すモデルでログ記録された 1 つ以上の mux またはバスの Simulink.Timeseries オブジェクトと Simulink.TSArray オブジェクトが格納されます。

• 1 つ以上の Simulink.SubsysDataLogs オブジェクトに、ModelDataLogs オブジェクトが表すモデルのサブシステム内でログ記録されたデータの Simulink.Timeseries、Simulink.TSArray、Simulink.SubsysDataLogs、Simulink.ModelDataLogs の各オブジェクトが格納されます。

• 1 つ以上の Simulink.ModelDataLogs オブジェクトに、ModelDataLogs オブジェクトが表すモデルのモデル参照内でログ記録されたデータの Simulink.Timeseries、Simulink.TSArray、Simulink.SubsysDataLogs、Simulink.ModelDataLogs の各オブジェクトが格納されます。

プロパティ

Name — ログ記録された信号データの名前

文字ベクトル

ログ記録された信号データの名前。文字ベクトルとして指定します。

BlockPath — モデル内の信号を生成するブロックのパス

文字ベクトル

モデル内の信号を生成するブロックのパス。文字ベクトルとして指定します。

PortIndex — モデル内の信号を生成するブロックの端子のインデックス

整数

モデル内の信号を生成するブロックの端子のインデックス。整数として指定します。

SignalName — モデル内の信号の名前

文字ベクトル

モデル内の信号の名前。文字ベクトルとして指定します。

ParentName — mux またはバス要素の親の名前

文字ベクトル

mux またはバス要素の親の名前。文字ベクトルとして指定します。mux またはバスの一部でない信号の場合、ParentName プロパティは SignalName プロパティと同じです。

TimeInfo — 時間のメタデータ

Simulink.TimeInfo オブジェクト

時間のメタデータ。Simulink.TimeInfo オブジェクトとして指定します。

Time — ログ記録される時間の値

配列

ログ記録される時間の値。配列として指定します。

Data — ログ記録される信号の値

配列

ログ記録される信号の値。配列として指定します。

バージョン履歴

R2006a より前に導入

R2025a: 削除済み

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

R2024b: 削除予定

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

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 形式で保存されたデータを [データセット] 形式に変換することも可能で、この形式に変換するとデータ処理が簡単になります。詳細については、Dataset 形式へのデータの変換を参照してください。

参考

オブジェクト

• Simulink.SimulationOutput | Simulink.SimulationData.Dataset

トピック

• Dataset 形式へのデータの変換