Main Content

resample

timeseriestscollection 中的时间向量进行重采样

说明

示例

注意

resample 函数应用于使用 timeseriestscollection 创建的对象。有关重采样 timetable(不推荐重采样 timeseriestscollection)的信息,请参阅 retime

tsout = resample(tsin,timevec) 使用新时间向量对时间序列或集合进行重采样。resample 函数使用与每个时序关联的插值方法。

示例

tsout = resample(tsin,timevec,interpmethod) 使用指定的插值方法重采样。如使用线性插值,则 interpmethod'linear',如使用零阶保持,则为 'zoh'

tsout = resample(tsin,timevec,interpmethod,code)code 中的质量代码应用于所有样本。

示例

全部折叠

创建一个 timeseries 对象,并根据 timevec 中的时间使用线性插值对其进行重采样。将原始数据与重采样后的数据进行比较。

tsin = timeseries([1.1 2.9 3.7 4.0 3.0]',1:5);
tsout = resample(tsin,[1 1.5 3.5 4.5 4.9]);
tsindata = tsin.Data
tsindata = 5×1

    1.1000
    2.9000
    3.7000
    4.0000
    3.0000

tsoutdata = tsout.Data
tsoutdata = 5×1

    1.1000
    2.0000
    3.8500
    3.5000
    3.1000

对由两个 timeseries 对象构成的 tscollection 对象重采样。

使用两个 timeseries 对象创建一个 tscollection 对象。

ts1=timeseries([1.1 2.9 3.7 4.0 3.0]',1:5,'Name','Acceleration');
ts2=timeseries([3.2 4.2 6.2 8.5 1.1]',1:5,'Name','Speed');
tscin = tscollection({ts1,ts2})
Time Series Collection Object: unnamed

Time vector characteristics

      Start time            1 seconds
      End time              5 seconds

Member Time Series Objects:

      Acceleration
      Speed

使用零阶保持插值,根据新时间向量对 tscin 中的数据进行重采样。

tsout = resample(tscin,[1 1.5 3.5 4.5 4.9],'zoh')
Time Series Collection Object: unnamed

Time vector characteristics

      Start time            1 seconds
      End time              4.900000e+00 seconds

Member Time Series Objects:

      Acceleration
      Speed

输入参数

全部折叠

输入时间序列,指定为 timeseriestscollection 对象。

新时间向量,指定为重采样的时间向量。

当原始时间向量包含日期时间但 timevec 是数值时,resample 使用现有单位相对于 tsin.TimeInfo.StartDate 属性定义 timevec

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

插值方法,指定为以下选项之一:

  • 'linear' - 线性插值

  • 'zoh' - 零阶保持

质量代码,指定为 [] 或由从 -128 到 127 的整数构成的标量、向量或多维数组。

  • 当质量代码为向量时,它的长度必须与时间向量相同。每个元素应用于对应的数据样本。

  • 当质量代码值为数组时,它的大小必须与数据数组相同。每个元素应用于数据数组的对应数据元素。

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

版本历史记录

在 R2006a 之前推出