tscollection

R2026b

创建 tscollection 对象

全页展开

描述

tscollection 对象是一个或多个具有相同时间向量的 timeseries 对象的集合。timeseries 的集合对于分析同时发生的多个数据趋势很有用。

创建对象

要创建 tscollection 对象，请使用 tscollection 函数。

语法

tsc = tscollection(ts)
tsc = tscollection(timevals)
tsc = tscollection(___,Name,Value)

描述

tsc = tscollection(ts) 创建一个 tscollection 对象，其中包含 ts 中的 timeseries 对象。输入 ts 可以是单个 timeseries 对象，也可以是由 timeseries 对象组成的元胞数组。每个 timeseries 必须具有相同的时间向量。

示例

tsc = tscollection(timevals) 定义 tscollection 的时间向量。

tsc = tscollection(___,Name,Value) 使用一个或多个名称-值参量指定其他选项。

输入参量

全部展开

输入 timeseries，指定为标量或元胞数组。

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

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

名称-值参数

全部展开

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

如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: tsc = tscollection(ts,'Name','MyTSC')

tscollection 名称，指定为字符向量。

datenum 指示符，指定为 true 或 false。值为 true 表示 tscollection 对象的时间向量由 datenum 值组成。有关详细信息，请参阅 datenum。

数据类型: logical

属性

全部展开

tscollection 名称，以字符向量的形式表示。

时间值，表示为向量。

如果 TimeInfo.StartDate 为空，将相对于 0 测量值。定义 TimeInfo.StartDate 时，值表示相对于 StartDate 测量的日期字符向量。

Time 的长度必须与每个集合的 Data 的第一个或最后一个维度相同。

时间信息，表示为描述时间向量的以下字段的集合：

  • Units - 时间单位，其值为 'weeks'、'days'、'hours'、'minutes'、'seconds'、'milliseconds'、'microseconds' 或 'nanoseconds'。

  • Start - 开始时间。

  • End - 结束时间（只读）。

  • Increment - 后续时间值之间的间隔（如果时间采样不均匀，则为 NaN）。

  • Length - 时间向量的长度（只读）。

  • Format - 定义日期显示的字符向量（请参阅 datestr）。

  • StartDate - 定义参考日期的日期字符向量（请参阅 setabstime）。

  • UserData - 其他的用户定义信息。

要访问 tscollection 对象 tsc 某个字段的值，请使用 tsc.TimeInfo.field 语法形式进行访问。

对象函数

addsampletocollection向 tscollection 添加样本
addts将 timeseries 添加到 tscollection 中
delsamplefromcollection从 tscollection 中删除样本
getabstime将 timeseries 或 tscollection 时间向量转换为元胞数组
getsampleusingtimetimeseries 或 tscollection 数据的子集
gettimeseriesnamestscollection 中的 timeseries 的名称
removets从 tscollection 中删除 timeseries
resample对 timeseries 或 tscollection 中的时间向量进行重采样
setabstime将 timeseries 或 tscollection 时间设置为日期字符向量
settimeseriesnames重命名 tscollection 中的 timeseries

示例

全部折叠

打开实时脚本

使用两个 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');
ts = 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

版本历史记录

在 R2006a 之前推出

另请参阅

主题