timeseries オブジェクトの作成

時系列は、集団の動態や過程の時間発展を表します。これらは離散的な時間間隔でサンプリングされたデータ内のパターンおよび動作の識別、モデル化、および予測に使用されます。

メモ

timetable は timeseries よりも推奨されます。timetable では、さまざまな型のタイムスタンプ付きデータを格納することができ、前処理、再構成、解析用の幅広い一連のサポート関数が用意されています。

timeseries データ型を削除する予定はありません。

timeseries オブジェクトを作成するには、関数 timeseries を、データ サンプルを表す入力引数を指定して使用します。

例

ts = timeseries(datavals) は、datavals のデータを含む timeseries オブジェクトを返します。1 秒のタイム ステップで、ゼロ秒から開始する既定のサンプル時間を割り当てます。

ts = timeseries(datavals,timevals) は系列のサンプル時間を指定します。結果として得られるオブジェクトはデータを時間で並べ替えます。

ts = timeseries(datavals,timevals,quality) は、QualityInfo.Code で定義されたコードについての特性の説明を指定します。

ts = timeseries(___,'Name',tsname) は、timeseries オブジェクトの名前 tsname を指定します。

ts = timeseries() は、空の timeseries オブジェクトを返します。

ts = timeseries(tsname) は、名前が tsname である空の timeseries オブジェクトを作成します。

すべて展開する

サンプル データ。数値または logical スカラー、ベクトル、または多次元配列として指定します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

サンプル時間。数値スカラーまたは数値ベクトル、あるいは日付文字ベクトルの cell 配列として指定します。有効な日付文字ベクトルは、次の形式で表すことができます。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | cell

特性コード。[] または -128 ～ 127 の範囲の整数のスカラー、ベクトル、または多次元配列として指定します。

特性コードの値がベクトルの場合は、時間ベクトルと同じ長さでなければなりません。各要素は、対応するデータ サンプリングに適用されます。

特性コードの値が配列の場合は、データ配列と同じサイズでなければなりません。各要素は、データ配列の対応する要素に適用されます。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

timeseries の名前。文字ベクトルとして指定します。

すべて展開する

サンプル データ。数値または logical スカラー、ベクトル、または多次元配列として表されます。データの最初の次元か最後の次元のいずれかが、時間ベクトルの方向と一致していなければなりません。

Data には、以下の属性があります。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

データ情報。次のフィールドの集合として表されます。

Units — データ単位を指定する文字ベクトル。

Interpolation — 内挿法を指定する tsdata.interpolation オブジェクト。

tsdata.interpolation オブジェクトのフィールドは、以下を含みます。

Fhandle — ユーザー定義の内挿関数の関数ハンドル。

Name — 内挿法の名前を指定する文字ベクトル。線形内挿の場合は 'linear' (既定)、ゼロ次ホールドの場合は 'zoh' などの方法があります。

UserData — 追加のユーザー定義情報。文字ベクトルとして入力します。

イベント情報。イベント情報を含む tsdata.event オブジェクトの配列として表されます。

tsdata.event オブジェクトのフィールドは、以下を含みます。

EventData — イベントに関する追加のユーザー定義の情報。

Name — イベントの名前を指定する文字ベクトル。

Time — イベントが発生する時間。実数または日付文字ベクトルとして指定します。

Units — 時間の単位。

StartDate — 基準日。日付文字ベクトルとして指定します。時間ベクトルが数値の場合、StartDate は空となります。

時間ベクトルの配置。次のいずれかのオプションとして表されます。

true — データ配列の最初の次元が、時間ベクトルに合わせて割り当てられます。例: ts = timeseries(rand(3,3),1:3);

false — データ配列の最後の次元が、時間ベクトルに合わせて割り当てられます。例: ts = timeseries(rand(3,4,5),1:5);

IsTimeFirst には、以下の属性があります。

時間ベクトルの長さ。スカラーとして表されます。

Length には、以下の属性があります。

timeseries の名前。文字ベクトルとして表されます。

特性コード。[] または -128 ～ 127 の範囲の整数のスカラー、ベクトル、または多次元配列として表されます。

特性コードの値がベクトルの場合は、時間ベクトルと同じ長さでなければなりません。各要素は、対応するデータ サンプリングに適用されます。

特性コードの値が配列の場合は、データ配列と同じサイズでなければなりません。各要素は、データ配列の対応する要素に適用されます。

Quality には、以下の属性があります。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Quality コードを記述するための特性情報。以下のフィールドの集合として表されます。

Code — 特性コードを定義する、-128 から 127 の値をもつ整数ベクトル。Quality プロパティを使用すると、これらの整数値のいずれかを各 Data 値に割り当てることができます。

Description — 文字ベクトルの cell 配列。各要素は、関連する特性 Code の読み取り可能な記述を示します。

UserData — 追加のユーザー定義情報。

Code と Description の長さは、一致しなければなりません。

時間値。ベクトルとして表されます。

TimeInfo.StartDate が空の場合、値は 0 と比較して計算されます。TimeInfo.StartDate が定義された場合、値は StartDate と比較して計算された日付文字ベクトルを示します。

Time の長さは、Data の最初または最後の次元と同じでなければなりません。

Time には、以下の属性があります。

時間情報。時間ベクトルを記述する次のフィールドの集合として表されます。

Units — 値 'weeks'、'days'、'hours'、'minutes'、'seconds'、'milliseconds'、'microseconds'、または 'nanoseconds' をもつ時間単位。

Start — 開始時間。

End — 終了時間 (読み取り専用)。

Increment — 後続の時間値の間隔 (時間が等間隔にサンプリングされていない場合は NaN)。

Length — 時間ベクトルの長さ (読み取り専用)。

Format — 日付表示を定義する文字ベクトル (datestr を参照)。

StartDate — 基準日を定義する日付文字ベクトル (setabstime を参照)。Format と同じ形式を使用して StartDate を指定します。

UserData — 追加のユーザー定義情報。

フィールドの値にアクセスするには、timeseries オブジェクト ts の ts.TimeInfo.field の形式を使用します。

欠損値インジケーター。次のオプションのいずれかとして表されます。

true — すべての NaN 値を欠損データとして扱います。ただし、記述統計関数を除きます。

false — NaN 値を記述統計関数に含め、NaN を結果に伝播させます。

ユーザー データ。timeseries オブジェクトに追加する任意のデータとして表されます。

すべて展開する

すべて折りたたむ

5 個のスカラー データ サンプルがある timeseries オブジェクトを作成し、timeseries の名前を指定します。次に、サンプル時間およびデータ値を表示します。

5 個のデータ サンプルがある timeseries を作成します。各サンプルは長さが 2 の列ベクトルです。したがって、ゼロ秒から開始する 2 つのサンプル時間があります。

10 秒の間隔でサンプリングされた 5 個のデータ サンプルがある timeseries を作成します。

すべて展開する

timeseries オブジェクトを表示する変数エディターのサポートは将来のリリースで削除される予定です。変数エディターで時間インデックス付きのデータを表示するには、代わりに timetable を使用してください。

timetable | tscollection | tsdata.event | timeseries2timetable