addsample

在 timeseries 对象中添加数据样本

全页折叠

语法

tsout = addsample(tsin,'Data',datavals,'Time',timevals)
tsout = addsample(tsin,'Data',datavals,'Time',timevals,Name,Value)
tsout = addsample(tsin,s)

说明

tsout = addsample(tsin,'Data',datavals,'Time',timevals) 使用数据数组 datavals 和对应的时间向量 timevals 向 timeseries 对象 tsin 添加一个或多个数据样本。

示例

tsout = addsample(tsin,'Data',datavals,'Time',timevals,Name,Value) 指定使用一个或多个名称-值对组添加数据样本的附加信息。

示例

tsout = addsample(tsin,s) 添加其信息包含在结构体 s 中的数据。

示例

全部折叠

打开实时脚本

在一个 timeseries 对象中添加和更改数据。

创建一个 timeseries 对象 ts1 并显示数据和时间采样。 

ts1 = timeseries((0:10:50)',(0:5)');
ts1.Data
ans = 6×1

     0
    10
    20
    30
    40
    50


ts1.Time
ans = 6×1

     0
     1
     2
     3
     4
     5

将一个数据样本添加到 ts1 的末尾。

ts2 = addsample(ts1,'Data',60,'Time',6);
ts2.Data
ans = 7×1

     0
    10
    20
    30
    40
    50
    60


ts2.Time
ans = 7×1

     0
     1
     2
     3
     4
     5
     6

将 ts2 中的最后一个数据样本从 60 更改为 100。

ts3 = addsample(ts2,'Data',100,'Time',6,'OverwriteFlag',true);
ts3.Data
ans = 7×1

     0
    10
    20
    30
    40
    50
   100

输入参数

全部折叠

输入 timeseries，指定为标量。

样本数据，指定为数值或 logical 标量、向量或多维数组。

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

采样时间，指定为数值标量或向量，或指定为日期字符向量元胞数组。有效的日期字符向量和字符串可以采用以下格式：

格式示例
dd-mmm-yyyy HH:MM:SS01-Mar-2000 15:45:17
dd-mmm-yyyy01-Mar-2000
mm/dd/yy03/01/00
mm/dd03/01
HH:MM:SS15:45:17
HH:MM:SS PM3:45:17 PM
HH:MM15:45
HH:MM PM3:45 PM
mmm.dd,yyyy HH:MM:SSMar.01,2000 15:45:17
mmm.dd,yyyyMar.01,2000
mm/dd/yyyy03/01/2000

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

示例结构体，指定为类型为 struct 的标量，并具有以下可选字段：

  • s.data - 数据的数值数组

  • s.time - 数值时间向量，或有效日期字符向量或字符串的元胞数组

  • s.quality - 从 -128 到 127 的质量代码的整数数组

  • s.overwriteflag - 覆盖指示符，指定为 true 可使用所添加样本覆盖现有数据样本

数据类型: struct

名称-值参数

全部折叠

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

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

示例: tsout = addsample(tsin,'Data',5,'Time',3,'OverwriteFlag',true)

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

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

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

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

覆盖指示符，指定为逻辑值，用于控制是否覆盖与所添加样本具有相同关联时间的数据样本。true 指示所添加数据覆盖之前的数据，而 false 会直接添加样本，从而导致重复时间值。

数据类型: logical

版本历史记录

在 R2006a 之前推出

另请参阅

| |