parcelstow
收藏资源简介:
ParcelStow 数据集是一个用于机器人灵巧操作研究的基准数据集,包含 970,565 个控制步骤,来自 937 个成功的专家演示,覆盖三种接触丰富的操作任务:包裹插入(parcel insertion)、直立放置(upright placement)和键控销插入(keyed peg insertion)。每个任务对应不同的速度因子(r),定义任务阶段的名义持续时间缩放比例。数据集以 Parquet 格式存储,每行记录一个 50Hz 的控制步骤,字段包括演示索引(episode)、步骤索引(step)、任务标识(task)、速度因子(rate)、状态观测(observation,147 个 float32 值)和归一化关节位置动作(action,16 个 float32 值)。此外,数据集还提供了训练好的 ACT 策略检查点、演示视频以及专家与 ACT 策略在不同速度因子下的成功率对比表。该数据集旨在支持模仿学习、时间鲁棒性分析和灵巧操作策略评估,适用于机器人学习和控制领域的研究。
The ParcelStow dataset is a benchmark dataset for robotic dexterous manipulation research, containing 970,565 control steps from 937 successful expert demonstrations, covering three contact-rich manipulation tasks: parcel insertion, upright placement, and keyed peg insertion. Each task corresponds to a different speed factor (r), defining the nominal duration scaling of the task phases. The dataset is stored in Parquet format, with each row recording a control step at 50Hz, including fields: episode index, step index, task identifier, rate, observation (147 float32 values), and normalized joint position action (16 float32 values). Additionally, the dataset provides trained ACT policy checkpoints, demonstration videos, and a success rate comparison table between experts and ACT policies under different speed factors. This dataset is intended to support imitation learning, temporal robustness analysis, and dexterous manipulation policy evaluation, suitable for research in robot learning and control.
ParcelStow Demonstrations, Checkpoints, and Videos
数据集概述
该数据集包含 970,565 个控制步,来自 937 条成功的专家演示,覆盖三个接触丰富的操作任务。数据集伴随 ParcelStow——一个基于 Isaac Lab 的基准测试套件,用于在不同时间缩放条件下比较学习到的操作策略与其专家演示者的任务成功率。速度因子 r 定义每种条件:它将指定为缩放的阶段标称时长除以 r,而固定阶段保持标称时长。标称条件为 r=1,在 r=2 时,缩放阶段时长为其标称值的一半。
任务配置
| 配置名称 | 任务描述 | 成功专家演示数 | 演示速度范围 |
|---|---|---|---|
parcel_insertion |
将包裹插入开口容器 | 297 | r in [0.5, 2.0] |
upright_placement |
将长方体重新定向到目标区域的稳定竖直姿态 | 315 | r in [0.75, 1.75] |
peg_insertion |
将键控销钉插入每侧间隙为 3mm 的方形凹槽 | 325 | r in [0.5, 1.0] |
任务成功率(100 次评估)
| 任务 | 专家在 r=1 |
ACT 在 r=1 |
专家在 r=2 |
ACT 在 r=2 |
|---|---|---|---|---|
| Parcel insertion | 100/100 | 100/100 | 84/100 | 53/100 |
| Upright placement | 92/100 | 39/100 | 43/100 | 8/100 |
| Keyed peg insertion | 93/100 | 75/100 | 87/100 | 0/100 |
在 r=2 条件下,专家成功率在包裹插入任务中比 ACT 高 31 个百分点,竖直放置高 35 个百分点,键控销钉插入高 87 个百分点。包裹插入的 r=2 条件在演示速度范围内,而竖直放置和销钉插入的 r=2 条件超出演示速度范围。
数据模式
每个 Parquet 行表示一个 50 Hz 控制步:
| 字段 | 类型 | 含义 |
|---|---|---|
episode |
int32 |
演示片段索引 |
step |
int32 |
片段内控制步索引 |
task |
string | 任务标识 |
rate |
float32 |
速度因子 r |
observation |
147 个 float32 值 |
提供给专家的状态观测 |
action |
16 个 float32 值 |
归一化关节位置动作 |
三个任务共享相同的维度与关节位置动作语义。姿态项在包裹插入中命名为 parcel_pose,在竖直放置和键控销钉插入中命名为 object_pose。
文件关系
data/*.parquet:演示数据,采用 Hugging Face Datasets 布局demonstrations/*.pt:相同演示数据的张量布局版本,供 GitHub 训练脚本使用checkpoints/*.pt:已发布的策略检查点videos/:选定片段视频及带 JSON 侧车的压缩包
检查点角色与限制
- ACT-A(
act_stow.pt):在 297 条包裹演示上训练,在r=1下专家与 ACT-A 均达到 100/100 成功率,提供论文中主要的标称匹配对比。 act_upright.pt:在 315 条演示上训练,在r=1下 ACT 成功率 39/100,专家 92/100,属于次要结果。act_peg.pt:在 325 条演示上训练,在r=1下 ACT 成功率 75/100,专家 93/100;在r >= 1.5时 ACT 成功率为 0/100,属于次要结果。
所有结果均来自 Isaac Lab 模拟,不提供硬件或模拟到现实的验证。
使用示例
python from datasets import load_dataset
task = "parcel_insertion" # upright_placement or peg_insertion demonstrations = load_dataset("cenwerem/parcelstow", task, split="train")
bash
下载任务特定检查点
python scripts/download_artifacts.py --task parcel python scripts/download_artifacts.py --task upright python scripts/download_artifacts.py --task peg
评估专家或策略
python scripts/evaluate.py --task parcel --actor expert
复现结果(无需 Isaac Lab 或 GPU)
python3 scripts/reproduce.py all-tasks
视频内容
| 文件 | 内容 |
|---|---|
parcel_expert_r2_2x_faster.mp4 |
包裹插入专家在 r=2 下的演示片段 |
upright_expert_r1_2x_faster.mp4 |
竖直放置专家在 r=1 下的演示片段 |
peg_expert_r1_2x_faster.mp4 |
键控销钉插入专家在 r=1 下的演示片段 |
parcel_expert_vs_act_r2_2x_faster.mp4 |
专家与 ACT 在 r=2 下的对比:专家成功,ACT 方向误差超阈值 |
upright_expert_vs_act_r2_2x_faster.mp4 |
专家与 ACT 在 r=2 下的对比:专家成功,ACT 放置后倾倒 |
peg_expert_vs_act_r2_2x_faster.mp4 |
专家与 ACT 在 r=2 下的对比:专家成功,ACT 未获取销钉 |
视频仅说明单次片段结果,总体成功率数据来源于 GitHub 评估记录。
许可与引用
数据集基于 Apache-2.0 许可证发布。
论文预印本:arXiv:2609.01453;代码与安装见 GitHub 仓库。




