Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

tscollection

创建 tscollection 对象

说明

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

创建对象

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

说明

示例

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

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

输入参数

全部展开

输入 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

名称-值对组参数示例: tsc = tscollection(ts,'Name','MyTSC')

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在单引号 (' ') 中。您可以按照任意顺序指定名称-值对组参数,例如 Name1,Value1,Name2,Value2

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 中删除样本
horzcat水平串联 tscollection 对象
removetstscollection 中删除 timeseries
resampletscollection 时间向量重采样
set设置 tscollection 的属性
setabstimetscollection 时间设置为日期字符向量
settimeseriesnames重命名 tscollection 中的 timeseries
vertcat垂直串联 tscollection 对象
get查询 tscollection 属性
getabstimetscollection 时间向量转换为元胞数组
getsampleusingtimetscollection 数据的子集
gettimeseriesnamestscollection 中的 timeseries 的名称
isempty确定 tscollection 是否为空
lengthtscollection 时间向量的长度
sizetscollection 的大小

示例

全部折叠

使用两个 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 之前推出