LogBrowser 使用指南¶

LogBrowser 用于查看和整理一个目录下的实验记录。先安装 GUI extra，然后指定记录的父目录启动：

logqbit browser ./runs

不指定目录时，Browser 会打开当前目录或最近使用的目录。Change dir... 可切换目录，旁边的按钮可新开窗口；界面会记住最近打开的目录和主题选择。

浏览记录¶

Browser 左侧是记录列表，右侧是当前记录的详情。含有 metadata.json 的直接子目录会被识别为记录。单击表头可排序；右键表头可显示创建时间、创建机器和绘图轴等列，也可筛选是否显示星标或回收站记录。

右键点击记录可进行常用整理操作：

• 修改标题或 ID，创建一条没有数据的笔记记录；
• 设置星标、标记为回收站项目，或移入系统回收站；
• 在文件管理器中打开记录目录；
• 导出多条记录，或将多条记录合并为一条新记录。

双击记录会在独立窗口中打开它。文件新增或内容变化时界面会自动刷新；也可以按 F5 手动刷新。

常用快捷键：

快捷键	操作
F2	修改标题
F3	修改 ID
Ctrl/Cmd + N	创建笔记记录
S	切换星标
0–3	设置星标数量
T	切换回收站标记
Delete	移入系统回收站
Ctrl + Enter	在文件管理器中打开记录
← / →	切换详情标签页

查看记录内容¶

右侧详情包含三个主要标签页：

• Const.：显示实验常量和配置。
• Data：显示表格数据。较大的表格先显示一部分行，点击 Show More Rows 继续加载；右键列可查看该列的不同取值。
• Plot：根据数据列绘制曲线或二维色图。

记录目录中的图片会显示为额外标签页。Files... 菜单可打开记录中的任意文件，或在文件管理器中显示整个目录。

绘图¶

在 Plot 页顶部，把列名拖到相应区域来选择用途：

axes | fields | ignored

• 一个坐标轴加一个或多个数据列，绘制 1D 曲线。
• 两个坐标轴和一个数据列，绘制 2D 色图。
• group by 可按一个或多个列分组绘制。

右键列条并选择 Save，将当前绘图选择保存到记录；下次打开会自动恢复。若尚未选择列，Browser 会尝试使用前几列给出可用的初始图。

图中可用鼠标缩放和拖动。右键图像可保存 PNG 或切换对数坐标；1D 图还可调整 marker 的 Small、Medium 或 Large 尺寸。copy 或 Ctrl+C 可复制当前图像。启用 cursor 后，单击图像可移动 cursor；移动鼠标时会显示半透明预览和坐标。在二维图中，cursor 还会显示横、纵截面。

对于 1D 曲线，fit exp 和 fit x² 可分别进行指数和二次拟合：点击按钮后，用鼠标框选参与拟合的数据点。按 Esc、再次点击按钮或右键可退出拟合模式。