tscollection

tscollection オブジェクトの作成

このページをすべて展開する

説明

tscollection オブジェクトは同じ時間ベクトルをもつ 1 つ以上の timeseries オブジェクトの集合です。timeseries の集合は、同時に発生する複数のデータのトレンドを解析するのに役立ちます。

作成

tscollection オブジェクトの作成には関数 tscollection を使用します。

構文

tsc = tscollection(ts)

tsc = tscollection(timevals)

説明

例

tsc = tscollection(ts) は、ts の timeseries オブジェクトを含む tscollection オブジェクトを作成します。入力 ts は、単一の timeseries オブジェクトまたは timeseries オブジェクトの cell 配列にすることができます。各 timeseries は同じ時間ベクトルをもたなければなりません。

tsc = tscollection(timevals) は tscollection の時間ベクトルを定義します。

入力引数

すべて展開する

`ts` — 入力 `timeseries`
スカラー | cell 配列

入力 timeseries。スカラーまたは cell 配列として指定します。

`timevals` — サンプル時間
スカラー | ベクトル

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

形式	例
`dd-mmm-yyyy HH:MM:SS`	`01-Mar-2000 15:45:17`
`dd-mmm-yyyy`	`01-Mar-2000`
`mm/dd/yy`	`03/01/00`
`mm/dd`	`03/01`
`HH:MM:SS`	`15:45:17`
`HH:MM:SS PM`	`3:45:17 PM`
`HH:MM`	`15:45`
`HH:MM PM`	`3:45 PM`
`mmm.dd,yyyy HH:MM:SS`	`Mar.01,2000 15:45:17`
`mmm.dd,yyyy`	`Mar.01,2000`
`mm/dd/yyyy`	`03/01/2000`

名前と値のペアの引数例: tsc = tscollection(ts,'Name','MyTSC')

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は一重引用符 (' ') で囲まなければなりません。Name1,Value1,Name2,Value2 のように、名前と値のペアの引数を任意の順序で指定できます。

`Name` — `tscollection` の名前
文字ベクトル

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

`isDatenum` — `datenum` インジケーター
`true` (既定値) | `false`

datenum インジケーター。true または false として指定します。true の値は、tscollection オブジェクトのベクトルが datenum 値で構成されることを示します。詳細については、datenum を参照してください。

データ型: logical

プロパティ

すべて展開する

`Name` — `tscollection` の名前
文字ベクトル

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

`Time` — 時間値
ベクトル

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

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

Time の長さは、各コレクションの Data の最初または最後の次元と同じでなければなりません。

`TimeInfo` — 時間情報
フィールドの集合

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

Units — 値 'weeks'、'days'、'hours'、'minutes'、'seconds'、'milliseconds'、'microseconds' または 'nanoseconds' をもつ時間単位。
Start — 開始時間。
End — 終了時間 (読み取り専用)。
Increment — 後続の時間値の間隔 (時間が一様にサンプリングされていない場合は NaN)。
Length — 時間ベクトルの長さ (読み取り専用)。
Format — 日付表示を定義する文字ベクトル (datestr を参照)。
StartDate — 基準日を定義する日付文字ベクトル (setabstime を参照)。
UserData — 追加のユーザー定義情報。

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

オブジェクト関数

すべて展開する

変更および結合

`addsampletocollection`	サンプルを `tscollection` に追加
`addts`	`timeseries` を `tscollection` に追加
`delsamplefromcollection`	`tscollection` からサンプルを削除
`horzcat`	`tscollection` オブジェクトの水平方向の連結
`removets`	`tscollection` からの `timeseries` の削除
`resample`	`tscollection` 時間ベクトルのリサンプリング
`set`	`tscollection` プロパティの設定
`setabstime`	`tscollection` 時間を日付文字ベクトルとして設定
`settimeseriesnames`	`tscollection` の `timeseries` の名前の変更
`vertcat`	`tscollection` オブジェクトの垂直方向の連結

クエリ

`get`	`tscollection` プロパティのクエリ
`getabstime`	`tscollection` 時間ベクトルの cell 配列への変換
`getsampleusingtime`	`tscollection` データのサブセット
`gettimeseriesnames`	`tscollection` の `timeseries` の名前
`isempty`	`tscollection` が空かどうかを判別
`length`	`tscollection` 時間ベクトルの長さ
`size`	`tscollection` のサイズ

例

すべて折りたたむ

`tscollection` の作成

ライブスクリプトを開く

2 つの timeseries オブジェクトから tscollection オブジェクトを作成します。

ts1 = timeseries([1.1 2.9 3.7 4.0 3.0]',1:5,...
'Name','Acceleration');
ts2 = timeseries([3.2 4.2 6.2 8.5 1.1]',1:5,...
'Name','Speed');
ts = tscollection({ts1;ts2})

Time Series Collection Object: unnamed

Time vector characteristics

      Start time            1 seconds
      End time              5 seconds

Member Time Series Objects:

      Acceleration
      Speed

参考

timeseries

トピック

時系列オブジェクトとコレクション

R2006a より前に導入

tscollection

説明

作成

構文

説明