gettsafterevent

イベント後の timeseries の作成

ページ内をすべて折りたたむ

構文

tsout = gettsafterevent(tsin,tsevent)
tsout = gettsafterevent(tsin,tsevent,n)

説明

tsout = gettsafterevent(tsin,tsevent) は、入力 timeseries tsin 内でイベント tsevent 後にサンプルが発生する timeseries オブジェクトを返します。引数 tsevent には tsdata.event オブジェクトまたはイベントの名前を含む文字ベクトルを指定できます。tsevent が tsdata.event オブジェクトの場合、tsevent で定義される時間で時間を指定します。tsevent が文字ベクトルの場合、イベント名に一致する tsin の Events プロパティ内の最初の tsdata.event オブジェクトで時間を指定します。

例

tsout = gettsafterevent(tsin,tsevent,n) は、tsin のイベント後にサンプルが発生する timeseries オブジェクトを返します。ここで、n はイベント tsevent のイベント発生回数です。

例

すべて折りたたむ

ライブ スクリプトを開く

時間サンプル 2 にイベントが発生する timeseries オブジェクトを作成します。 

tsin = timeseries((1:5)');
tsevent = tsdata.event('MyEvent',2);
tsin = addevent(tsin,tsevent);
tsin.Events
    EventData: []
         Name: 'MyEvent'
         Time: 2
        Units: 'seconds'
    StartDate: ''

イベント サンプル後のデータを含む新しい timeseries オブジェクトを作成します。 

tsout = gettsafterevent(tsin,'MyEvent');
tsout.Time
ans = 2×1

     3
     4

入力引数

すべて折りたたむ

入力 timeseries。スカラーとして指定します。

データ型: timeseries

イベント。スカラー tsdata.event オブジェクトまたはイベントの名前を含む文字ベクトルとして指定します。

イベント回数。timeseries オブジェクトの n 番目の tsdata.event を表すスカラー整数として指定します。

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

ヒント

  • 入力 timeseries オブジェクト tsin に日付文字ベクトルが含まれ、tsevent が数値の時間を使用する場合、tsevent によって選択される時間は tsin.TimeInfo 内の StartDate プロパティを基準にして計算された日付として扱われます。

  • tsin が数値の時間を使用し、tsevent がカレンダー日付を使用する場合、tsevent によって選択された時間は、カレンダー日付には関連付けされていない数値として扱われます。

バージョン履歴

R2006a より前に導入

参考

| | | |