清华大学Apache IoTDB
用户1009
添加快捷方式
分享
TsFileDataFrame用户手册
输入“/”快速插入内容
TsFileDataFrame用户手册
用户1009
用户1009
用户7302
用户7302
用户2236
用户2236
用户5908
用户5908
用户501
用户501
用户4882
用户4882
4月2日修改
快速上手
TsFileDataFrame能够让你像操作 DataFrame 一样读取TsFile 中的时序数据,无需关心底层文件格式和数据加载细节。
代码块
Python
from tsfile import TsFileDataFrame
df = TsFileDataFrame("data/")
# 加载目录下所有
TsFile
# 浏览所有序列
ts = df["weather.Beijing.humidity"]
# 取一条序列
window = ts[20:100]
# 按行号切片 -> np.ndarray
data = df.loc[start:end, [
# 按时间戳对齐
多条序列
"weather.Beijing.temperature",
"weather.Beijing.humidity",
]]
data.values
# -> np.ndarray, shape=(N, 2)
接口总览
TsFileDataFrame围绕着三个核心类型:
•
TsFileDataFrame:
入口对象,加载一至多个 TsFile 并提供统一视图。初始化时只扫描元数据,不读取实际数值。
•
Timeseries:
单条时间序列的懒加载句柄。通过 df[...]的数组操作获得,包含序列元信息但不立即读取,仅在行号索引时才触发数据读取
•
AlignedTimeseries:
多条序列的时间对齐结果。通过df.
loc
[...]获取,一次性将指定时间范围内的多条序列对齐到同一时间轴并读入内存
TsFileDataFrame
Timeseries
AlignedTimeseries