Main Content

addsampletocollection

tscollection 添加样本

说明

示例

tscout = addsampletocollection(tscin,'Time',timevals,tsname,tsdata) 将数据样本添加到名称 tsname 为一个或多个时间值指定的 tscollection 成员中。tsdata 包含样本数据。

要一次向多个 tscollection 成员添加样本,请继续列出每个 tscollection 成员名称,后跟相应的数据,并以逗号分隔。例如,命令 tscout = addsampletocollection(tscin,'Time',timevals,ts1name,ts1data,ts2name,ts2data) 将样本同时添加到 tscin 中的两个 timeseries 中。

示例

全部折叠

根据两个 timeseries 对象创建一个 tscollection 对象,并向 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});
tscout = addsampletocollection(tscin,'Time',3.5,'Acceleration',10,'Speed',4.9);
tscout.Acceleration.Data
ans = 6×1

    1.1000
    2.9000
    3.7000
   10.0000
    4.0000
    3.0000

tscout.Speed.Data
ans = 6×1

    3.2000
    4.2000
    6.2000
    4.9000
    8.5000
    1.1000

输入参数

全部折叠

输入 tscollection,指定为标量。

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

格式示例
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

timeseries 名称,指定为字符向量。

数据类型: char

timeseries 数据,指定为数值或 logical 标量、向量或多维数组。

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

提示

  • 如果您没有为 tscollection 成员指定数据样本,则该 timeseries 将为 timevals 中指定的时间包含 NaN 值作为数值数据。对于逻辑数据,timeseries 将包含 false 值。

  • tscollection 需要 Quality 值时,您可以使用以下语法同时指定数据质量代码和数据样本:

    tsc = addsampletocollection(tsc,'Time',timevals,...
    ts1name,ts1cellarray,ts2name,ts2cellarray,...)

    在第一个元胞数组元素中指定数据,在第二个元胞数组元素中指定 Quality

    如果 tscollection 成员已经具有 Quality 值,但您只提供了数据样本,则将在现有 Quality 数组中由 timevals 指定的时间处添加 0

版本历史记录

在 R2006a 之前推出