load_from_tsfile#

load_from_tsfile(full_file_path_and_name, replace_missing_vals_with='NaN', return_y=True, return_data_type='nested_univ', encoding='utf-8')[源代码][源代码]#

将时间序列 .ts 文件加载到 X 和(可选)y 中。

从 .ts 文件加载的数据被导入到一个嵌套的 pd.DataFrame 中,或者根据请求可选地导入到一个二维的 np.ndarray(等长,单变量问题)或三维的 np.ndarray(等长,多变量问题)中。如果存在,y 被加载到一个一维的 np.ndarray 中。

参数:
完整文件路径和名称str

要读取的 .ts 文件的完整路径和文件名。

replace_missing_vals_withstr, 默认 NaN

在解析之前,文本文件中缺失的值应替换为的值。

return_y布尔值,默认 True

是否返回 y 变量,如果它存在的话。

返回数据类型str, 可选, 默认 = “nested_univ”

返回 X 的内存数据格式规范。str 可以是任何其他支持的 Panel mtype。

关于mtypes的列表,请参见 datatypes.SCITYPE_REGISTER;关于规范,请参见 examples/AA_datatypes_and_datasets.ipynb

常用规范:

“nested_univ: 嵌套的 pd.DataFrame, pd.Series 在单元格中 “numpy3D”/”numpy3d”/”np3D”: 3D np.ndarray (实例, 变量, 时间索引) “numpy2d”/”np2d”/”numpyflat”: 2D np.ndarray (实例, 时间索引) “pd-multiindex”: 具有2级 (实例, 时间) MultiIndex 的 pd.DataFrame”

如果数据无法存储在请求的类型中,则会引发异常。

编码: str

encoding 是使用 open 函数读取文件时所使用的编码名称。

返回:
Xsktime 兼容的内存容器,mtype 返回数据类型

关于mtypes的列表,请参见 datatypes.SCITYPE_REGISTER;关于规范,请参见 examples/AA_datatypes_and_datasets.ipynb

y仅在 return_y=True 时返回,np.ndarray
引发:
如果请求的文件不存在,则引发 IOError
如果输入序列的维度不一致(不支持),则引发 IOError
如果请求了类别标签但文件中不存在,则引发 IOError
如果输入文件没有案例,则引发 IOError
如果 return_data_type = numpy3d 但数据是长度不等的时间序列,则抛出 ValueError
如果 return_data_type = numpy2d 但数据是多元的,则引发 ValueError。
或不等长序列