tsdata.event

tsdata.event オブジェクトの作成

説明

tsdata.event オブジェクトは、プロパティ内に timeseries オブジェクトのイベント情報を含んでいます。tsdata.event のイベントを timeseries に追加するために、関数 addevent を使用できます。

作成

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

構文

tse = tsdata.event(eventname,eventtime)

tse = tsdata.event(eventname,eventtime,'Datenum')

説明

tse = tsdata.event(eventname,eventtime) は、時間 eventtime に発生する eventname という名前の tsdata.event オブジェクトを作成します。

tse = tsdata.event(eventname,eventtime,'Datenum') は、eventtime 値が関数 datenum によって生成されるシリアル日付値であることを示します。eventtime は、イベントが作成されると日付文字ベクトルに変換されます。

入力引数

eventname — イベント名

文字ベクトル

イベント名。文字ベクトルとして指定します。

eventtime — イベント時間

スカラー

イベント時間。数値スカラーとして指定します。

プロパティ

EventData — イベント データ

配列

イベント データ。イベントに関するユーザー定義情報を含む配列として表されます。

Name — イベント名

文字ベクトル

イベント名。文字ベクトルとして表されます。

Time — イベント時間

ベクトル

時間値。数値スカラーとして表されます。

Units — 時間単位

'weeks' | 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds' | 'microseconds' | 'nanoseconds'

時間単位。'weeks'、'days'、'hours'、'minutes'、'seconds'、'milliseconds'、'microseconds' または 'nanoseconds' として指定します。

StartDate — 開始日

文字ベクトル

開始日。有効な datestr 文字ベクトルとして指定します。

オブジェクト関数

findEvent	名前による tsdata.event のクエリ
getTimeStr	tsdata.event 時間のクエリ

例

イベントの作成

tsdata.event オブジェクトを作成します。

tse = tsdata.event('MyEvent',6)

    EventData: []
         Name: 'MyEvent'
         Time: 6
        Units: 'seconds'
    StartDate: ''

timeseries オブジェクトを作成して、イベントを timeseries に追加します。

ts = timeseries((1:5)',1:5);
ts = addevent(ts,tse);
ts.Events

    EventData: []
         Name: 'MyEvent'
         Time: 6
        Units: 'seconds'
    StartDate: ''

バージョン履歴

R2006a より前に導入

参考

timeseries | datenum | addevent | datestr

トピック

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