synchronize

使用公共时间向量同步两个 timeseries 对象并重采样

全页折叠

语法

[ts1,ts2] = synchronize(ts1,ts2,synchronizemethod)
[ts1,ts2] = synchronize(___,Name,Value)

说明

注意

此 synchronize 函数应用于使用 timeseries 函数创建的对象。有关同步 timetable（不推荐同步 timeseries）的信息，请参阅 synchronize。

[ts1,ts2] = synchronize(ts1,ts2,synchronizemethod) 使用公共时间向量和指定的方法，通过同步 ts1 和 ts2 创建两个新的 timeseries 对象。

[ts1,ts2] = synchronize(___,Name,Value) 在上述语法的基础上，指定 Name,Value 对组参量形式的一个或多个额外选项来创建两个新 timeseries 对象。

示例

示例

全部折叠

打开实时脚本

创建两个 timeseries 对象，使 ts1.timeinfo.StartDate 比 ts2.timeinfo.StartDate 晚一天。

ts1 = timeseries([1 2],[datestr(now); datestr(now+1)]);
ts2 = timeseries([1 2],[datestr(now-1); datestr(now)]);

将 ts1.timeinfo.StartDate 更改为匹配 ts2.timeinfo.StartDate 并将 ts1.Time 更改为 1。

[ts1 ts2] = synchronize(ts1,ts2,'union');

以下命令保留 ts1.timeinfo.StartDate 并使 ts1.Time 保持为 0。

[ts1 ts2] = synchronize(ts1,ts2,'union','KeepOriginalTimes',true);

输入参数

全部折叠

第一个输入 timeseries，指定为标量。

数据类型: timeseries

第二个输入 timeseries，指定为标量。

数据类型: timeseries

同步方法，指定为以下选项之一：

  • 'Union' - 使用属于 ts1 和 ts2 的时间向量并集的时间向量在两个时间向量重叠的时间范围内对 timeseries 对象重采样。

  • 'Intersection' - 根据属于 ts1 和 ts2 的时间向量交集的时间向量对 timeseries 对象重采样。

  • 'Uniform' - 需要如下所示的其他参量：

    [ts1,ts2] = synchronize(ts1,ts2,'Uniform','Interval',value)

    该方法根据均匀时间向量对时间序列重采样，其中 value 指定两个连续样本之间的时间间隔。均匀时间向量是 ts1 和 ts2 的时间向量的重叠部分。间隔单位是 ts1 和 ts2 的较小单位。

名称-值参数

全部折叠

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: [ts1,ts2] = synchronize(ts1,ts2,'tolerance',1e-13)

用于同步操作的插值方法，如使用线性插值则指定为 'linear'，如使用零阶保持则指定为 'zoh'。插值方法也可以指定为包含用户定义的插值方法的 tsdata.interpolation 对象。

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

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

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

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

原始时间向量，指定为 true 以保留原始时间值，或指定为 false 以使用其他时间值。

数据类型: logical

容差，指定为实数值标量，定义用于区分 ts1 和 ts2 两个时间值的容差。例如，ts1 中的第六个时间值是 5+(1e-12)，而 ts2 中的第六个时间值是 5-(1e-13)，这两个值默认都视为 5。要区分这两个时间，您可以将 'tolerance' 设置为较小的值，例如 1e-15。

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

输出参量

全部折叠

同步并重采样的第一个输出 timeseries，指定为标量。

数据类型: timeseries

同步并重采样的第二个输出 timeseries，指定为标量。

数据类型: timeseries

版本历史记录

在 R2006a 之前推出

另请参阅

|