b1k-torque-sidecars
收藏资源简介:
BEHAVIOR-1K Torque Sidecars数据集是为BEHAVIOR-1K 2026挑战赛演示补充官方发布中缺失的关节力矩、重力和科里奥利力信号而创建的。它通过重新模拟原始演示(启用物理引擎)并记录求解器实际测量值生成,确保每个episode通过(task_id, demo_id)与官方episode一一对应。数据集目前包含2,452个episode,覆盖全部100个任务,但覆盖不均衡:6个任务已完成(各200个episode),大多数任务仅包含1个覆盖episode,数据收集仍在进行中。数据以HDF5文件格式存储,每个文件对应一个episode,包含一个229维的本体感知向量,其布局通过文件属性`proprio_layout`(JSON格式)自描述,具体包括:官方61维挑战状态(用于与原始演示对齐)、28维关节位置、28维关节速度、28维测量的关节扭矩(主要信号,单位N·m)、28维控制器指令扭矩、28维重力项和28维科里奥利力项。重要提示:测量的关节扭矩中不包含重力负载,重力项是假设性查询结果,并非实测扭矩的组成部分。接触力隐含在测量扭矩与指令扭矩的差值中。每个文件还包含丰富的元数据属性,如任务ID和名称、演示ID、步数、环境配置、场景文件、OmniGibson版本哈希、重放配置等。数据通过教师强制重放获取:在每帧恢复记录的模拟器状态,让机器人控制器执行记录的动作进行一个物理步(动作频率30 Hz,物理频率120 Hz),并记录PhysX测量的关节力。重放过程禁用渲染以节省资源,并使用CPU PhysX求解器以确保数值一致性。数据集存在已知限制:覆盖不均衡,小任务代表性过高;测量的努力中不包含重力负载;接触力未存储为显式通道。数据集适用于测试力感知是否改进操作策略、接触检测、动力学识别以及力条件表示学习。
The BEHAVIOR-1K Torque Sidecars dataset provides the joint torque, gravity, and Coriolis force signals that were missing from the official release of the BEHAVIOR-1K 2026 Challenge demonstrations. This dataset is generated by re-simulating the original demonstrations (with the physics engine enabled) and recording the actual measured values from the solver, ensuring that each episode has a one-to-one correspondence with the official episode via the (task_id, demo_id) pair. Currently, the dataset contains 2,452 episodes covering all 100 tasks, but with uneven coverage: 6 tasks have been fully completed (with 200 episodes each), while most tasks only have 1 covered episode, and data collection is still ongoing. The data is stored in HDF5 file format, with each file corresponding to one episode and containing a 229-dimensional proprioceptive vector. The layout of this vector is self-documented via the file attribute `proprio_layout` (in JSON format), which specifically includes: the official 61-dimensional challenge state (for alignment with the original demonstrations), 28-dimensional joint positions, 28-dimensional joint velocities, 28-dimensional measured joint torques (the primary signal, unit: N·m), 28-dimensional controller command torques, 28-dimensional gravity terms, and 28-dimensional Coriolis force terms. Important note: The measured joint torques do not include gravitational loads; the gravity terms are hypothetical query results and not part of the actual measured torques. Contact forces are implicitly contained in the difference between the measured torques and the command torques. Each file also contains rich metadata attributes, such as task ID and name, demonstration ID, number of steps, environment configuration, scene file, OmniGibson version hash, replay configuration, and more. The data is obtained via teacher-forced replay: at each frame, the recorded simulator state is restored, and the robot controller executes the recorded actions for one physics step (action frequency: 30 Hz, physics frequency: 120 Hz), while recording the joint forces measured by PhysX. Rendering is disabled during replay to save resources, and the CPU PhysX solver is used to ensure numerical consistency. The dataset has known limitations: uneven coverage with overrepresentation of small tasks; measured joint efforts do not include gravitational loads; contact forces are not stored as explicit channels. The dataset is suitable for testing whether force perception improves manipulation strategies, contact detection, dynamics recognition, and force-conditioned representation learning.
数据集概述:BEHAVIOR-1K Torque Sidecars
该数据集为 BEHAVIOR-1K 2026 挑战赛 的官方演示数据补充了每帧的关节力矩、重力和科里奥利力信号,弥补了官方发布中不包含这些通道的空白。
核心特性
- 任务类别:机器人技术(Robotics)。
- 许可协议:MIT。
- 数据规模:1K < N < 10K 条样本。
- 当前状态:包含 100 个任务,共 2,452 个片段。其中 6 个任务已完成(每个 200 个片段),其余大多数任务当前仅包含 1 个覆盖性片段,数据收集仍在进行中。
数据内容与结构
数据以 HDF5 格式存储,每个片段一个文件,命名格式为 chunk_<demo_id>_1.hdf5。
-
数据层级:
data/→demo_0/包含:action(T, 23):回放时记录的动作。obs/robot_r1::proprio(T, 229):核心专有感知数据。task::low_dim(T, 274):任务相关的物体状态。
reward(T,),terminated(T,),truncated(T,)
-
229 维专有感知向量:布局通过每个文件中的
proprio_layout属性(JSON 格式)描述,无需硬编码偏移量。主要内容包括:[0:61]:官方挑战状态(61 维),用于与官方数据集对齐。[61:89],[89:117]:关节位置与速度。[117:145]:关节测量力矩 (N·m),是主要信号,代表 PhysX 净传输力。[145:173]:控制器指令力矩。[173:201]:重力项 g(q)。[201:229]:科里奥利/离心力项 c(q,q̇)。
特别注意:由于 OmniGibson 机器人设置中禁用了非基座链接的重力,测量力矩中不包含重力负载。
joint_gravity是 PhysX 的“假设”查询,不应从测量力矩中减去以恢复“外力”。 -
文件属性:每个文件都包含丰富的元数据,如
task_id,task_name,proprio_layout,manifest,n_steps,config,scene_file,omnigibson_git_hash等,使文件具备自描述性。
数据集布局
task-0000/ … task-0099/ # 深度收集,每任务最多 200 个片段 chunk_<demo_id>_1.hdf5 _manifest.json # 任务完成 200 个片段时写入 partial.json # 任务仍在填充时写入 coverage-1ep/task-XXXX/ # 早期的单个片段覆盖扫描 chunk<demo_id>_1.hdf5
coverage-1ep/是一个独立的命名空间,其中 145 个片段可能与深度收集部分重复。去重时应依据(task_id, demo_id),而非文件数量。
数据生成方法
数据通过重新模拟官方原始遥操作演示得到,采用“教师强制”回放:
- 在每帧恢复记录的模拟器状态。
- 机器人控制器执行记录的动作,通过物理引擎(CPU PhysX 求解器)步进。
- 记录 PhysX 测量的关节力矩。
该过程为无相机回放,并将 VRAM 占用从 13.9 GB 降至 2.7 GB。禁止使用 GPU 求解器,因为其计算结果未通过力矩等效性检查。
数据完整性重要说明
- 该数据集已完全清除早期受污染的生成版本。早期版本因批处理环境导致场景错乱,力矩数据虽物理正确但属于错误场景。
- 数据完整性标记:文件名中的
chunk size(即_1)是关键标记。当前所有文件均为chunk_<demo>_1.hdf5,这确保了结构上的免疫性。任何文件名中N ≥ 2 的文件均来自受污染批次,应予以丢弃。 - 被拯救的有效片段文件会包含
extracted_from属性作为记录。
与官方数据集关联
通过 (task_id, demo_id) 进行匹配。challenge_61 切片是来自官方数据集的原始 61 维状态,可直接用于验证对齐性。
已知局限性
- 覆盖率不均匀:每个任务的中位数片段数为 1,仅 6 个任务完成。
- 样本偏差:轻量级任务的重放速度更快,因此覆盖率更高;最重、接触最丰富的场景当前覆盖最少。
- 力矩信号特性:测量力矩中无重力负载。
- 接触力:未作为独立通道存储,隐含在测量力矩与指令力矩的差值中。
预期用途
主要用于研究力觉感知是否能够提升操作策略的性能,也可用于接触检测、动力学识别以及以力为条件的表征学习。




