gettsafteratevent

R2026b

创建事件发生当时或之后的 timeseries

全页折叠

语法

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

描述

tsout = gettsafteratevent(tsin,tsevent) 返回一个 timeseries 对象，包含在 timeseries 输入 tsin 中的事件 tsevent 发生时和发生之后的样本。参量 tsevent 可以是 tsdata.event 对象或包含事件名称的字符向量。如果 tsevent 是 tsdata.event 对象，则由 tsevent 定义的时间来指定时间。如果 tsevent 是字符向量，则由 tsin 的 Events 属性中与事件名称匹配的第一个 tsdata.event 对象来指定时间。

示例

tsout = gettsafteratevent(tsin,tsevent,n) 返回一个 timeseries 对象，包含在 tsin 中的某个事件发生时和发生之后的样本，其中 n 是事件 tsevent 的发生次数。

示例

全部折叠

打开实时脚本

创建一个 timeseries 对象，其中包含一个在时间采样 2 时发生的事件。 

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

创建一个新的 timeseries 对象，其中包含来自 tsin 的事件样本以及该事件发生之后的所有样本的数据。 

tsout = gettsafteratevent(tsin,'MyEvent');
tsout.Time
ans = 3×1

     2
     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 之前推出

另请参阅

| | | |