timeseries2timetable

将 timeseries 对象转换为时间表

自 R2021b 起

全页折叠

语法

TT = timeseries2timetable(ts)

TT = timeseries2timetable(ts1,...,tsN)

说明

示例

TT = timeseries2timetable(ts) 将 timeseries 数组 ts 转换为时间表。

如果 ts 是 timeseries 对象，则 TT 是具有一个变量的时间表。
如果 ts 是由 timeseries 对象组成的数组，则 TT 是一个包含的变量数与 ts 中的 timeseries 对象数相同的时间表。ts 中的所有 timeseries 对象必须具有相同的采样时间。

示例

TT = timeseries2timetable(ts1,...,tsN) 将 timeseries 对象 ts1,...,tsN 转换为一个时间表。TT 中的变量数等于输入数。所有 timeseries 对象 ts1,...,tsN 必须具有相同的采样时间。

示例

全部折叠

将 `timeseries` 对象转换为时间表

打开实时脚本

创建一个包含五个随机数的 timeseries 对象，以 10 秒为间隔进行采样。

ts = timeseries(rand(5,1),[0 10 20 30 40])

  timeseries

  Common Properties:
            Name: 'unnamed'
            Time: [5x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [5x1 double]
        DataInfo: tsdata.datametadata

显示 ts 中的时间和数据。

ts.Time

ts.Data

将 ts 转换为一个时间表。

TT = timeseries2timetable(ts)

TT=5×1 timetable
     Time      Data  
    ______    _______

    0 sec     0.81472
    10 sec    0.90579
    20 sec    0.12699
    30 sec    0.91338
    40 sec    0.63236

来自 `timeseries` 对象数组的时间表

打开实时脚本

创建一个 timeseries 对象数组。使用相同的采样时间向量，但为时间序列提供不同的名称。使用 rand 函数创建不同的数据值数组。

ts1 = timeseries(rand(5,1),[0 10 20 30 40],"Name","Series_1");
ts2 = timeseries(rand(5,1),[0 10 20 30 40],"Name","Series_2");
ts3 = timeseries(rand(5,1),[0 10 20 30 40],"Name","Series_3");
ts = [ts1 ts2 ts3]

  1x3 timeseries array with properties:

    Events
    Name
    UserData
    Data
    DataInfo
    Time
    TimeInfo
    Quality
    QualityInfo
    IsTimeFirst
    TreatNaNasMissing
    Length

将来自所有 timeseries 对象的数据合并到一个时间表中。数组中的每个时间序列都为该时间表提供一个变量。

TT = timeseries2timetable(ts)

TT=5×3 timetable
     Time     Series_1    Series_2    Series_3
    ______    ________    ________    ________

    0 sec     0.81472     0.09754     0.15761 
    10 sec    0.90579      0.2785     0.97059 
    20 sec    0.12699     0.54688     0.95717 
    30 sec    0.91338     0.95751     0.48538 
    40 sec    0.63236     0.96489     0.80028

输入多个时间序列

打开实时脚本

将多个输入转换为一个时间表。

ts1 = timeseries(rand(5,1),[0 10 20 30 40],"Name","Series_1");
ts2 = timeseries(rand(5,1),[0 10 20 30 40],"Name","Series_2");
ts3 = timeseries(rand(5,1),[0 10 20 30 40],"Name","Series_3");
TT = timeseries2timetable(ts1,ts2,ts3)

TT=5×3 timetable
     Time     Series_1    Series_2    Series_3
    ______    ________    ________    ________

    0 sec     0.81472     0.09754     0.15761 
    10 sec    0.90579      0.2785     0.97059 
    20 sec    0.12699     0.54688     0.95717 
    30 sec    0.91338     0.95751     0.48538 
    40 sec    0.63236     0.96489     0.80028

输入参数

全部折叠

`ts` — 输入时间序列
`timeseries` 对象数组

输入时间序列，指定为由 timeseries 对象组成的数组。

此函数使用 ts 的部分属性来分配数据或设置时间表中的属性。对于每个 timeseries 属性，该表描述输出时间表中的结果。

输入 `timeseries` 属性	输出时间表中的结果
`Name`	指定对应时间表变量的名称。如果 `Name` 为 `'unnamed'`（默认值），则对应的变量名称为 `'Data'`（当多个时间序列的名称为 `'unnamed'` 时，为 `'Data_1'`、`'Data_2'` 等，以此类推）。
`Data`	指定分配给对应时间表变量的数据。
`DataInfo.Units`	为对应的时间表变量设置 `VariableUnits` 属性。
`DataInfo.Interpolation`	为对应的时间表变量设置 `VariableContinuity` 属性。
`Time`	将采样时间转换为时间表的行时间。根据输入的 `Time` 和 `TimeInfo` 属性中的信息，行时间向量可以是 `duration` 或 `datetime` 向量。
`TimeInfo.Units`	指定行时间的单位。如果时间表行时间向量是 `duration` 向量，则 `TimeInfo.Units` 还确定其格式。
`TimeInfo.Format`	设置行时间的格式。
`TimeInfo.StartDate`	设置时间表的 `StartTime` 属性。
`TimeInfo.Increment`	设置 `TimeStep` 属性。
`TimeInfo.Start`	计算从 `TimeInfo.StartDate` 的偏移量，以指定时间表的 `StartTime` 属性。
`IsTimeFirst`	确定数据是否需要重定向。
`UserData`	将数据赋给时间表的 `UserData` 属性。
`Events`	警告。
`Quality`	警告。
`QualityInfo`	如果 `timeseries` 对象具有 `Quality` 属性，则发出警告。