主题
记录格式、时间轴与完整性
操作与界面见回看运行记录。本文解释数据来源、时钟与完整性边界。
Rerun 是物理与硬件记录唯一正式离线回放和诊断入口。React 工作台负责在线编辑、求解与任务跟踪;离线导出不重新执行物理或改变任务成功判据。
安装、导出与打开
默认文件名为 artifacts/rerun/<run-id>.rrd;episode 使用 <run-id>-<episode>.rrd。 同时生成同名 .json,保存源 run、输入/manifest/模型哈希、导出器哈希、SDK 版本、帧数与 RRD 哈希。 记录包含默认面板布局、几何和图像,可复制到另一台安装相同版本 Rerun 的机器打开。 SDK 固定 0.42.0,官方 Linux ARM64 wheel 的来源与 SHA-256 由工作区 uv.lock 保存。
导出使用独立 recordings.py 的 load_recording,校验输入、结果、模型包与关节映射, 额外要求相机索引、标称参数和每帧文件都在结果哈希中。 仅接受 completed run;物理无效或任务失败仍可导出,状态会明确保留。 源 run 内不能作为输出目的地,已有 RRD 或同名 JSON 不会被覆盖,失败不留下部分导出。
面板与时间轴
- 三维场景使用该 run 保存的模型:机器人视觉网格、环境碰撞几何、动态物体和逐体记录位姿。 全部连杆直接使用测得的世界位姿,不按当前代码重算 FK。
- 启用的每路相机都有 RGB、光轴 Z 深度和观测状态页签;深度单位为米,光学轴为右/下/前。 内参与安装仍是原 run 的标称假设,不是实机标定。
- 下方面板提供关节位置(rad),观测有效性/帧龄,以及任务阶段和原始任务事件。 关节速度(rad/s)和命令位置(rad)也保存在实体树中。
- 绿色点表示该相机的可用位置估计;无效或过期时清除,避免旧结果一直挂在场景里。 原始图像保留到下一帧,不能仅凭图像仍显示就判断观测可用。
时间面板默认选择 sim_time:相机帧在交付时刻出现,之前无法看到。 机器人和事件保持实际仿真时间;相机使用采集时的世界外参。 因此延迟的腕部图像、点云和视锥可能落后于当前手腕,这是已收到的历史观测。 该视图显示所有相机的交付情况;控制器实际选用了哪一帧,以任务事件中的相机 ID/sequence 为准。
切换为 capture_time 可检查采集时的几何关系:图像、点云与该时刻机器人姿态对齐。 尚未交付的末尾帧只出现在此时间轴,不能把它当作控制器当时已知的信息。 任务决策仍位于实际发生时刻,不会随图像提前。标称参数是 static,暂停/拖动不会推进物理。 两条时间轴均按纳秒量化,避免浮点累计误差使最后一步已交付的帧消失。
验证
rerun profile 使用合成的已校验 run,直接读取导出的 RRD Arrow chunk,验证采集/交付时间、 未交付帧隔离、末步浮点误差、保存外参、wxyz→xyzw、深度米制、过期/无效估计清除, 以及篡改/未登记帧/错误外参/重复输出拒绝;无需启动查看器或物理后端。 根 CLI 分发测试在 core/unit profile 中,命令发现不导入 Rerun、NumPy。
本机示例来自既有成功视觉双臂 episode: runs/physics-a28e715173d54d53993bf53419a69695。 导出目标为 artifacts/isaaclab-migration/phase2/visual-dual-final.rrd。 此记录验证接入与回放,不代表新增物理任务验收或实机传感器精度。
当前记录为 27.35 s、1369 个状态样本、三路相机共 819 帧 RGB-D。实际导出与来源哈希已核对;此记录尚未进行原生查看器画面或桌面鼠标操作验收。
2026-11-14 的独立浏览器验收另对 physics-da80fdd737054851bc1cfc9072ec8aa1 实际点击导出和下载;下载文件 216095552 字节,SHA-256 与服务器 RRD 一致。证据见 artifacts/gpu-browser-acceptance-20261114/rerun-download.json 和同目录报告、截图。此项覆盖网页导出/下载,仍未覆盖原生 Rerun 查看器的画面与时间轴操作。
当前边界
归档方向统一为 RRD。ROS 遥操已通过 Rerun 官方 rosbag2_storage_rrd 直接写入 bag/*.rrd,使用 raw 保存完整 ROS 消息、lenses 保存官方可视化表示; 归档与来源见 ROS 集成。插件未作源码修改,版本与哈希由 backends/ros2/rrd-storage.json 固定,构建和使用见命令入口。 上游仍将插件标为实验性;本项目的 Jazzy/ARM64 读写与现有 SDK 兼容性验证见 记录与数据状态。
仿真轨迹、逐步任务测量、相机 RGB-D、设备观察、SDK 调用、业务事件和验收时序统一直接写 RRD。 Python 复用官方 RecordingStream / RrdReader,原生 SDK 诊断复用官方 C++ SDK;没有自写 RRD 编解码器。 事件用 TextLog 保存原有异构字段,record_index 保持跨 chunk 的完整顺序;数值数据用有类型的 Arrow 组件保存,另保留 shape/dtype。float64 关节、float32 深度、uint8 RGB 和整数时钟不降精度。 每个连续事件文件有计数和结束标记;缺少结束标记只允许诊断读取,不能作为完整归档。 仿真轨迹使用 array_stream schema:静态模型/关节/刚体元数据只写一次,动态列按 block_index 分块,最终标记包含块数与样本数。统一读取入口检查连续序号、列形状与结束标记后重建数组;历史 arrays schema 仍可读取。写入线程按块 flush,不在物理线程结束时一次性编码整段轨迹。 相机索引在重置和归档前关闭,尚未交付的帧仍保留 capture/delivery 边界。
原始 RRD 分别由其生产者持有;离线导出添加归档模型、坐标转换和面板布局,不重复执行仿真。 配置、模型、最终结果和完整性清单保留 JSON。在线网页读取有界 *.latest.json IPC 快照, 快照可降采样且不纳入归档;完整数据只在 RRD 中。没有因此增加进程。 不再读取历史 NPZ/NDJSON/JSONL 记录;历史 run 的文件和哈希不修改。 CAD 静态几何交换不是时序归档,保持各自领域格式。 实际读回证据见 记录与数据状态。 当前未接入实时查看器或远程记录服务。 RGB 与 float32 深度按原始数据保存,长记录体积较大,未添加有损压缩或降采样。 采样之间不新增机器人状态;拖动时使用 Rerun 的最近记录值。 完整性校验通过不等于渲染正确,查看器画面需要另行验收。
判据与硬件观察
归档判据按每个事实自身的 sim_time 记录;变化快照保留事件时间,不用当前帧时间冒充证据时间。归档最终契约另列为静态文档,并注明它不是所有历史时刻已知的信息。缺少判据时显示 unavailable,三值 null 保持未知。失败与物理无效记录也可导出,其最终状态明确保留。
硬件记录由 pride_core.hardware.load_observation 校验;六关节原始编码器和状态进入 RRD。三维显示来自该记录保存的安装模型与标称 FK,明确不等于实测世界位姿;无效编码器隐藏标称机器人。host_time 是主机单调接收时间相对首样本的时长,host_receipt_utc 是主机 UTC 接收时刻,controller_time 是独立控制器时钟。没有曝光/采集时间或跨时钟同步证据,不能推断传输延迟。硬件观察不产生任务成功判据。