TsFileDataFrame用户手册

用户1009

用户7302

用户2236

用户5908

用户501

用户4882

4月2日修改

快速上手

TsFileDataFrame能够让你像操作 DataFrame 一样读取TsFile 中的时序数据，无需关心底层文件格式和数据加载细节。​

代码块

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

TsFileDataFrame用户手册​

TsFileDataFrame用户手册