Simulink.TimeInfo

(削除済み) Simulink.Timeseries オブジェクトの時間データのメタデータ

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

説明

Simulink.TimeInfo オブジェクトには、単位や開始時間と終了時間など、Simulink.Timeseries オブジェクトの時間データのメタデータが格納されます。

作成

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

ModelDataLogs オブジェクトに、モデル内のそれぞれのログ信号、mux 要素、およびバス要素の Simulink.Timeseries オブジェクトが含まれています。それぞれの Simulink.Timeseries オブジェクトに Simulink.TimeInfo オブジェクトがあります。

プロパティ

Units — 時間データの単位

文字ベクトル

時間データの単位。文字ベクトルとして指定します。

例: 'seconds'

Start — 時間データの開始時間

スカラー | 配列

時間データの開始時間。スカラーまたは配列として指定します。

• 条件付き実行サブシステム内以外の信号の場合、この値は Simulink.Timeseries オブジェクトを生成したシミュレーションの開始時間と一致するスカラーです。

• 条件付き実行サブシステム内の信号の場合、この値はサブシステムがアクティブになったときの時間を含む配列です。

End — 時間データの終了時間

スカラー | 配列

時間データの終了時間。スカラーまたは配列として指定します。

• 条件付き実行サブシステム内以外の信号の場合、この値は Simulink.Timeseries オブジェクトを生成したシミュレーションの終了時間と一致するスカラーです。

• 条件付き実行サブシステム内の信号の場合、この値はサブシステムが非アクティブになったときの時間を含む配列です。

Increment — サンプルレート

NaN | スカラー

サンプル レート。NaN またはスカラーとして返されます。

• 可変ステップ ソルバーを使用するシミュレーションでログ記録される連続サンプル時間をもつ信号の場合、この値は NaN です。

• 固定ステップ ソルバーを使用するシミュレーションでログ記録される離散サンプル時間と信号をもつ信号の場合、この値はスカラーです。

Length — 時間データのベクトルの長さ

読み取り専用: 整数

この プロパティ は読み取り専用です。

時間データのベクトルの長さ。整数として指定します。ベクトルの長さは、シミュレーションでログ記録されるサンプルの数を示します。

バージョン履歴

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 形式へのデータの変換