resample

对 timeseries 或 tscollection 中的时间向量进行重采样

全页折叠

语法

tsout = resample(tsin,timevec)
tsout = resample(tsin,timevec,interpmethod)
tsout = resample(tsin,timevec,interpmethod,code)

说明

注意

resample 函数应用于使用 timeseries 或 tscollection 创建的对象。有关重采样 timetable（不推荐重采样 timeseries 和 tscollection）的信息，请参阅 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

输入参数

全部折叠

输入时间序列，指定为 timeseries 或 tscollection 对象。

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

当原始时间向量包含日期和时间但 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 之前推出

另请参阅

| | | |