LogQbit¶
LogQbit 基于文件/文件夹保存实验数据，并提供图形化的数据浏览器。
安装¶
Python 中创建、写入和读取记录只需安装核心包：
pip install logqbit
数据浏览器等图形化界面需要 GUI extra：
pip install "logqbit[gui]"
随后可通过以下命令启动浏览器：
logqbit browser
创建快捷方式及其他功能介绍见命令行工具和LogBrowser 使用指南。
快速开始¶
from logqbit import LogFolder
log = LogFolder.new("./runs", title="cooldown")
log.add_row(time=0.0, temperature=300.0)
log.add_row(time=1.0, temperature=295.2)
log.add_const(sample="device-a", operator="alice")
log.meta.plot_axes = ["time"]
上例会在 runs/ 下创建一条新记录。
记录目录通常包含以下三个文件：
1/
├── data.feather
├── metadata.json
└── const.yaml
存入的数据可以直接获取：
print(log.df)
print(log.const["sample"])
读取已有记录使用 LogRecord：
from logqbit import LogRecord
record = LogRecord("./runs/1")
df = record.df
print(record.meta.title)
print(record.row_count, record.columns)
也可以直接通过 pandas 读取：
import pandas as pd
df = pd.read_feather("./runs/1/data.feather")
追加写入、批量浏览等更多功能见核心 API。