ZhaoRunyi/Piper_items_hand_over_place_0403

# Piper LeRobot Dataset Generated on `2026-04-03` by `convert_piper_hdf5_to_lerobot.py`. ## Summary - Repo id: `ZhaoRunyi/Piper_items_hand_over_place_0403` - Robot type: `aloha` - Input dir: `/workspace/data/hdf5/piper/items_hand_over_place` - Output dir: `/workspace/data/ZhaoRunyi/Piper_items_hand_over_place_0403` - FPS: `10` - Sampling mode: `full` - Leading group: `slave_cam_high` - Crop strategy: `LATEST_START` - Default leading tolerance: `0.1` s - Additional constraints: `[]` - Arm selection: `dual` -> `left, right` - Space ids: `all` -> `['joint', 'gripper', 'ee_pos', 'ee_rot']` - EE rotation format: `rot6d` - Gripper format: `raw` - Image preset: `all` -> `['observation.images.cam_high', 'observation.images.cam_left_wrist', 'observation.images.cam_right_wrist']` ## State / Action Index Map `action` uses the exact same index order as `observation.state`. | indices | arm | component | names | source | | --- | --- | --- | --- | --- | | 0-5 | left | joint | left_joint_waist, left_joint_shoulder, left_joint_elbow, left_joint_forearm_roll, left_joint_wrist_angle, left_joint_wrist_rotate | slave_left_arm/joint | | 6 | left | gripper | left_gripper | slave_left_arm/gripper | | 7-9 | left | ee_pos | left_ee_pos_x, left_ee_pos_y, left_ee_pos_z | slave_left_arm/ee_pose[:3] | | 10-15 | left | ee_rot | left_ee_rot6d_0, left_ee_rot6d_1, left_ee_rot6d_2, left_ee_rot6d_3, left_ee_rot6d_4, left_ee_rot6d_5 | slave_left_arm/ee_pose[3:6] -> rot6d | | 16-21 | right | joint | right_joint_waist, right_joint_shoulder, right_joint_elbow, right_joint_forearm_roll, right_joint_wrist_angle, right_joint_wrist_rotate | slave_right_arm/joint | | 22 | right | gripper | right_gripper | slave_right_arm/gripper | | 23-25 | right | ee_pos | right_ee_pos_x, right_ee_pos_y, right_ee_pos_z | slave_right_arm/ee_pose[:3] | | 26-31 | right | ee_rot | right_ee_rot6d_0, right_ee_rot6d_1, right_ee_rot6d_2, right_ee_rot6d_3, right_ee_rot6d_4, right_ee_rot6d_5 | slave_right_arm/ee_pose[3:6] -> rot6d | ## Notes - Timestamp alignment is done per HDF5 group. Each camera group and each arm group has its own `timestamp` dataset, which is treated like an individual topic timeline. - The leading group is `slave_cam_high`. In `full` mode every leading-group timestep is kept; in `fps` mode the leading timeline is resampled first and then all other groups are bound to it by nearest timestamp. - Piper HDF5 stores 6 arm joints plus one separate gripper scalar per arm. When both `joint` and `gripper` are enabled, the gripper is appended as the 7th dimension of that arm's joint block. - `ee_pose` rotation is interpreted as XYZ Euler angles in radians and converted to `rot6d` when needed. - `GRIPPER_FORMAT="01"` treats values in `[0, 1]` as normalized opening ratio and thresholds them with `GRIPPER_FULL_WIDTH=0.05` and `GRIPPER_THRESHOLD=0.01`. ## Image Keys | dataset key | hdf5 group | | --- | --- | | observation.images.cam_high | slave_cam_high | | observation.images.cam_left_wrist | slave_cam_left | | observation.images.cam_right_wrist | slave_cam_right | ## Feature Names `observation.state` / `action` names: ```text left_joint_waist, left_joint_shoulder, left_joint_elbow, left_joint_forearm_roll, left_joint_wrist_angle, left_joint_wrist_rotate, left_gripper, left_ee_pos_x, left_ee_pos_y, left_ee_pos_z, left_ee_rot6d_0, left_ee_rot6d_1, left_ee_rot6d_2, left_ee_rot6d_3, left_ee_rot6d_4, left_ee_rot6d_5, right_joint_waist, right_joint_shoulder, right_joint_elbow, right_joint_forearm_roll, right_joint_wrist_angle, right_joint_wrist_rotate, right_gripper, right_ee_pos_x, right_ee_pos_y, right_ee_pos_z, right_ee_rot6d_0, right_ee_rot6d_1, right_ee_rot6d_2, right_ee_rot6d_3, right_ee_rot6d_4, right_ee_rot6d_5 ```# Piper LeRobot 数据集 本数据集于`2026-04-03`由`convert_piper_hdf5_to_lerobot.py`脚本生成。 ## 摘要 - 仓库标识：`ZhaoRunyi/Piper_items_hand_over_place_0403` - 机器人类型：`aloha` - 输入目录：`/workspace/data/hdf5/piper/items_hand_over_place` - 输出目录：`/workspace/data/ZhaoRunyi/Piper_items_hand_over_place_0403` - 帧率（FPS）：`10` - 采样模式：`full` - 主导组：`slave_cam_high` - 裁剪策略：`LATEST_START` - 默认主导容差：`0.1` 秒 - 附加约束：`[]` - 机械臂选择：`dual` → `left, right`（双臂 → 左、右机械臂） - 空间标识：`all` → `['关节（joint）', '夹爪（gripper）', '末端执行器位姿（ee_pos）', '末端执行器旋转（ee_rot）']` - 末端执行器旋转格式：`rot6d` - 夹爪格式：`raw` - 图像预设：`all` → `['observation.images.cam_high', 'observation.images.cam_left_wrist', 'observation.images.cam_right_wrist']` ## 状态/动作索引映射 `动作（action）`与`观测状态（observation.state）`采用完全一致的索引顺序。 | 索引范围 | 机械臂 | 组成部分 | 名称 | 来源 | | --- | --- | --- | --- | --- | | 0-5 | 左侧 | 关节 | 左腰关节（left_joint_waist）、左肩关节（left_joint_shoulder）、左肘关节（left_joint_elbow）、左前臂回转关节（left_joint_forearm_roll）、左腕关节角度（left_joint_wrist_angle）、左腕关节旋转（left_joint_wrist_rotate） | 从左机械臂/关节组（slave_left_arm/joint） | | 6 | 左侧 | 夹爪 | 左夹爪（left_gripper） | 从左机械臂/夹爪组（slave_left_arm/gripper） | | 7-9 | 左侧 | 末端执行器位姿（ee_pos） | 左末端执行器X坐标（left_ee_pos_x）、左末端执行器Y坐标（left_ee_pos_y）、左末端执行器Z坐标（left_ee_pos_z） | 从左机械臂/末端执行器位取前3维（slave_left_arm/ee_pose[:3]） | | 10-15 | 左侧 | 末端执行器旋转（ee_rot） | 左末端执行器rot6d第0维（left_ee_rot6d_0）、左末端执行器rot6d第1维（left_ee_rot6d_1）、左末端执行器rot6d第2维（left_ee_rot6d_2）、左末端执行器rot6d第3维（left_ee_rot6d_3）、左末端执行器rot6d第4维（left_ee_rot6d_4）、左末端执行器rot6d第5维（left_ee_rot6d_5） | 从左机械臂/末端执行器位取后3维（slave_left_arm/ee_pose[3:6]）并转换为rot6d | | 16-21 | 右侧 | 关节 | 右腰关节（right_joint_waist）、右肩关节（right_joint_shoulder）、右肘关节（right_joint_elbow）、右前臂回转关节（right_joint_forearm_roll）、右腕关节角度（right_joint_wrist_angle）、右腕关节旋转（right_joint_wrist_rotate） | 从右机械臂/关节组（slave_right_arm/joint） | | 22 | 右侧 | 夹爪 | 右夹爪（right_gripper） | 从右机械臂/夹爪组（slave_right_arm/gripper） | | 23-25 | 右侧 | 末端执行器位姿（ee_pos） | 右末端执行器X坐标（right_ee_pos_x）、右末端执行器Y坐标（right_ee_pos_y）、右末端执行器Z坐标（right_ee_pos_z） | 从右机械臂/末端执行器位取前3维（slave_right_arm/ee_pose[:3]） | | 26-31 | 右侧 | 末端执行器旋转（ee_rot） | 右末端执行器rot6d第0维（right_ee_rot6d_0）、右末端执行器rot6d第1维（right_ee_rot6d_1）、右末端执行器rot6d第2维（right_ee_rot6d_2）、右末端执行器rot6d第3维（right_ee_rot6d_3）、右末端执行器rot6d第4维（right_ee_rot6d_4）、右末端执行器rot6d第5维（right_ee_rot6d_5） | 从右机械臂/末端执行器位取后3维（slave_right_arm/ee_pose[3:6]）并转换为rot6d | ## 说明 - 时间戳对齐按HDF5组进行。每个相机组与每个机械臂组均拥有独立的`timestamp`数据集，视作独立的话题时间线。 - 主导组为`slave_cam_high`。在`full`模式下，所有主导组时间步均被保留；在帧率模式下，首先对主导时间线进行重采样，随后通过最近邻时间戳将其他所有组绑定至该时间线。 - Piper HDF5格式为每台机械臂存储6个关节参数与1个独立的夹爪标量值。当同时启用`joint`与`gripper`时，夹爪参数将被追加至对应机械臂关节块的第7维。 - 末端执行器位姿（ee_pose）的旋转被解释为弧度制的XYZ欧拉角，必要时将转换为`rot6d`格式。 - 当`GRIPPER_FORMAT="01"`时，将`[0, 1]`区间内的值视为归一化开合度，并以`GRIPPER_FULL_WIDTH=0.05`与`GRIPPER_THRESHOLD=0.01`进行阈值处理。 ## 图像键 | 数据集键 | HDF5组 | | --- | --- | | `observation.images.cam_high` | `slave_cam_high` | | `observation.images.cam_left_wrist` | `slave_cam_left` | | `observation.images.cam_right_wrist` | `slave_cam_right` | ## 特征名称 `观测状态（observation.state）`与`动作（action）`的特征名称如下： text 左腰关节（left_joint_waist）、左肩关节（left_joint_shoulder）、左肘关节（left_joint_elbow）、左前臂回转关节（left_joint_forearm_roll）、左腕关节角度（left_joint_wrist_angle）、左腕关节旋转（left_joint_wrist_rotate）、左夹爪（left_gripper）、左末端执行器X坐标（left_ee_pos_x）、左末端执行器Y坐标（left_ee_pos_y）、左末端执行器Z坐标（left_ee_pos_z）、左末端执行器rot6d第0维（left_ee_rot6d_0）、左末端执行器rot6d第1维（left_ee_rot6d_1）、左末端执行器rot6d第2维（left_ee_rot6d_2）、左末端执行器rot6d第3维（left_ee_rot6d_3）、左末端执行器rot6d第4维（left_ee_rot6d_4）、左末端执行器rot6d第5维（left_ee_rot6d_5）、右腰关节（right_joint_waist）、右肩关节（right_joint_shoulder）、右肘关节（right_joint_elbow）、右前臂回转关节（right_joint_forearm_roll）、右腕关节角度（right_joint_wrist_angle）、右腕关节旋转（right_joint_wrist_rotate）、右夹爪（right_gripper）、右末端执行器X坐标（right_ee_pos_x）、右末端执行器Y坐标（right_ee_pos_y）、右末端执行器Z坐标（right_ee_pos_z）、右末端执行器rot6d第0维（right_ee_rot6d_0）、右末端执行器rot6d第1维（right_ee_rot6d_1）、右末端执行器rot6d第2维（right_ee_rot6d_2）、右末端执行器rot6d第3维（right_ee_rot6d_3）、右末端执行器rot6d第4维（right_ee_rot6d_4）、右末端执行器rot6d第5维（right_ee_rot6d_5）