addsampletocollection

向 tscollection 添加样本

全页折叠

语法

tscout = addsampletocollection(tscin,'Time',timevals,tsname,tsdata)

说明

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 之前推出

另请参阅

| |