Main Content

tscollection

创建 tscollection 对象

说明

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

创建对象

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

描述

示例

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 指示符,指定为 truefalse。值为 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 语法形式进行访问。

对象函数

addsampletocollectiontscollection 添加样本
addtstimeseries 添加到 tscollection
delsamplefromcollectiontscollection 中删除样本
getabstimetimeseriestscollection 时间向量转换为元胞数组
getsampleusingtimetimeseriestscollection 数据的子集
gettimeseriesnamestscollection 中的 timeseries 的名称
removetstscollection 中删除 timeseries
resampletimeseriestscollection 中的时间向量进行重采样
setabstimetimeseriestscollection 时间设置为日期字符向量
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 之前推出