# timeseries
创建 timeseries 对象
函数库: TyTimeSeries
# 语法
ts = timeseries(datavals)
ts = timeseries(datavals,timevals)
ts = timeseries(datavals,timevals;quality = quality)
ts = timeseries(___,name=tsname)
ts = timeseries()
ts = timeseries(name=tsname)
# 说明
ts = timeseries(datavals) 返回一个包含 datavals 中的数据的 timeseries 对象。示例
ts = timeseries(datavals,timevals)返回一个 timeseries 对象，该对象包含 datavals 中与向量 timevals 中的时间对应的数据。
ts = timeseries(datavals,timevals;quality = quality) 根据 QualityInfo.Code 定义的代码指定质量说明。。
ts = timeseries(___,name=tsname)为 timeseries 对象指定一个名称 tsname。
ts = timeseries() 返回一个空 timeseries 对象。
ts = timeseries(name=tsname) 创建一个名称为 tsname 的空 timeseries 对象。
# 示例
创建timeseries
创建一个具有 5 个标量数据样本的 timeseries 对象，指定该 timeseries 的名称。
import TyTimeSeries
ts1 = TyTimeSeries.timeseries(1:5, name = "MyTimeSeries")
创建一个具有 5 个数据样本的 timeseries，其中每个样本是一个长度为 2 的列向量。
ts2 = TyTimeSeries.timeseries(rand(2, 5))
创建一个具有 5 个数据样本（以 10 个时间单位为间隔进行采样）的 timeseries。
ts3 = TyTimeSeries.timeseries(1:5, [0 10 20 30 40])
# 输入参数
datavals - 样本数据标量 | 向量 | 多维数组
样本数据，指定为数值或 Bool 标量、向量或多维数组。
数据类型： Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64 | Bool
timevals - 采样时间标量 | 向量
采样时间，指定为数值标量或向量。
数据类型： Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64
quality - 质量代码[] （默认） | 标量 | 向量 | 多维数组
质量代码，指定为 [] 或由从 -128 到 127 的整数构成的标量、向量或多维数组。
当质量代码为向量时，它的长度必须与时间向量相同。每个元素应用于对应的数据样本。
当质量代码值为数组时，它的大小必须与数据数组相同。每个元素应用于数据数组的对应元素。
数据类型： Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64
name - timeseries名称字符串
timeseries 名称，指定为字符串。
# 属性
Data - 样本数据标量 | 向量 | 多维数组
样本数据，表示为数值或 Bool 标量、向量或多维数组。数据的第一个或最后一个维度必须与时间向量的方向相符。
数据类型： Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64 | Bool
DataInfo - 数据信息字段的集合
数据信息，表示为以下字段的集合：
Units - 用于指定数据单位的字符向量。
Interpolation - 指定插值方法。
UserData - 其他用户定义的信息，作为字符向量输入。
Events - 事件信息Tevent 对象的数组
事件信息，表示为包含事件信息的 Tevent 对象的数组。
Tevent 对象包含下列字段：
EventData - 有关事件的用户定义信息。
Name - 指定事件名称的字符向量。
Time - 事件发生的时间，指定为实数或日期字符向量。
Units - 时间单位。
StartDate - 参考日期，指定为日期字符向量。当时间向量为数值时，StartDate 为空。
IsTimeFirst - 时间向量对齐true | false
时间向量对齐，表示为以下选项之一：
true - 数据数组的第一维度与时间向量相符。例如，ts = timeseries(rand(3,3),1:3);
false - 数据数组的最后一个维度与时间向量相符。例如，ts = timeseries(rand(3,4,5),1:5);
Length - 时间向量长度标量
时间向量长度，表示为标量。
Name - timeseries名称字符向串
timeseries 名称，以字符串的形式表示。
Quality - 质量代码[] （默认） | 标量 | 向量 | 多维数组
质量代码，表示为 [] 或由从 -128 到 127 的整数构成的标量、向量或多维数组。
当质量代码为向量时，它的长度必须与时间向量相同。每个元素应用于对应的数据样本。
当质量代码值为数组时，它的大小必须与数据数组相同。每个元素应用于数据数组的对应元素。
数据类型： Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64
QualityInfo - 质量信息字段的集合
用于描述 Quality 代码的质量信息。
Time - 时间值向量
时间值，表示为向量。
如果 TimeInfo.StartDate 为空，将相对于 0 测量值。定义 TimeInfo.StartDate 时，值表示相对于 StartDate 测量的日期字符向量。
Time 的长度必须与 Data 的第一个或最后一个维度相同。
TimeInfo - 时间信息字段的集合
时间信息，表示为描述时间向量的以下字段的集合：
Units - 时间单位，其值为 Week、Day、Hour、Minute、Second、Milliseconds。
Start - 开始时间。
End - 结束时间（只读）。
Increment - 后续时间值之间的间隔。
Length - 时间向量的长度。
Format - 定义日期显示的字符向量。
StartDate - 定义参考日期的日期字符向量。
UserData - 其他的用户定义信息。
要访问 timeseries 对象 ts 某个字段的值，请使用 ts.TimeInfo.field 语法形式进行访问。
TreatNaNasMissing - 缺失值指示符true （默认） | false
缺失值指示符，表示为以下选项之一：
true - 将所有 NaN 值视为缺失数据（描述性统计量函数除外）。
false - 包含描述性统计量函数中的 NaN 值，从而将 NaN 传播到结果。
UserData - 用户数据[] （默认）
用户数据，表示为要添加到 timeseries 对象的任何其他数据。