gettsbetweenevents

创建两次事件之间的 timeseries

全页折叠

语法

tsout = gettsbetweenevents(tsin,tsevent1,tsevent2)
tsout = gettsbeforeevent(tsin,tsevent1,tsevent2,n1,n2)

说明

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

示例

tsout = gettsbeforeevent(tsin,tsevent1,tsevent2,n1,n2) 返回一个 timeseries 对象，包含在 tsin 中的两个事件之间发生的样本，其中 n1 是事件 tsevent1 的发生次数，n2 是事件 tsevent2 的发生次数。

示例

全部折叠

打开实时脚本

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

tsin = timeseries((1:5)');
tsevent1 = tsdata.event('StartEvent',1);
tsevent2 = tsdata.event('EndEvent',3);
tsin = addevent(tsin,[tsevent1 tsevent2]);

创建一个新的 timeseries 对象，其中包含这两个事件样本之间的数据。

tsout = gettsbetweenevents(tsin,'StartEvent','EndEvent');
tsout.Time
ans = 3×1

     1
     2
     3

输入参数

全部折叠

输入 timeseries，指定为标量。

数据类型: timeseries

开始事件，指定为标量 tsdata.event 对象或包含事件名称的字符向量。

结束事件，指定为标量 tsdata.event 对象或包含事件名称的字符向量。

开始事件编号，指定为与 timeseries 对象的第 n1 个 tsdata.event 对应的整数标量。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

结束事件编号，指定为与 timeseries 对象的第 n2 个 tsdata.event 对应的整数标量。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

提示

  • 当 timeseries 对象输入 tsin 包含日期字符向量而 tsevent1 和 tsevent2 使用数值时间时，所选时间被视为是相对于 tsin.TimeInfo 中的 StartDate 属性计算的日期。

  • 当 tsin 使用数值时间而 tsevent1 和 tsevent2 使用日历日期时，所选时间被视为是与日历日期没有关联的数值。

版本历史记录

在 R2006a 之前推出

另请参阅

| | |