Main Content

gettsbeforeatevent

创建事件发生时或发生之前的 timeseries

说明

示例

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

tsout = gettsbeforeatevent(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 = gettsbeforeatevent(tsin,'MyEvent');
tsout.Time
ans = 3×1

     0
     1
     2

输入参数

全部折叠

输入 timeseries,指定为标量。

数据类型: timeseries

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

事件编号,指定为整数标量,对应于 timeseries 对象的第 ntsdata.event

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

提示

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

  • tsin 使用数值时间而 tsevent 使用日历日期时,tsevent 选择的时间被视为是与日历日期没有关联的数值。

版本历史记录

在 R2006a 之前推出