G1_CameraPackaging_Dataset

This dataset was created using [LeRobot](https://github.com/huggingface/lerobot).

## Dataset Description

- **Homepage:** [More Information Needed]
- **Paper:** [More Information Needed]
- **License:** apache-2.0

- **Task Objective:** Place the RealSense D-405 camera into the mounting case and secure the lid.
- **Operational Objects:** A RealSense D-405 camera along with its original complete packaging (Purchase link: [【淘宝】退货运费险 https://e.tb.cn/h.60YgeNsj0ZmKJD1?tk=VwPYeJGcavx tG-#22>lD 「英特尔RealSense D405近距离7~50cm高精度毫米深度相机实感摄像头」点击链接直接打开 或者 淘宝搜索直接打开])
- **Operation Duration:** Each operation takes approximately 20 to 40 seconds.
- **Recording Frequency:** 30 Hz.
- **Robot Type:** 7-DOF dual-arm G1 robot.
- **End Effector:** Three-fingered dexterous hands.
- **Dual-Arm Operation:** Yes.
- **Image Resolution:** 640x480.
- **Camera Positions:** Wrist-mounted (monocular camera) + head-mounted (binocular cameras).
- **Data Content:**
• Robot's current state.
• Robot's next action.
• Current camera view images.
- **Robot Initial Posture:** The first robot state in each dataset entry.
- **Object Placement:** Position the camera case at the midpoint between the robot's arms in their initial state (arms vertical), 30cm away from the inner edge of the table's wall (robot-facing side). Place the camera on the right side of the case, and position the lid on the left side of the case.
- **Camera View:** Follow the guidelines in **Part 5** of [AVP Teleoperation Documentation](https://github.com/unitreerobotics/avp_teleoperate).

- **Important Notes:**
1. Due to the inability to precisely describe spatial positions, adjust the scene to closely match the first frame of the dataset after installing the hardware as specified in **Part 5** of [AVP Teleoperation Documentation](https://github.com/unitreerobotics/avp_teleoperate).
2. Data collection is not completed in a single session, and variations between data entries exist. Ensure these variations are accounted for during model training.

## Dataset Structure

[meta/info.json](meta/info.json):
```json
{
"codebase_version": "v2.0",
"robot_type": "Unitree_G1",
"total_episodes": 201,
"total_frames": 256253,
"total_tasks": 1,
"total_videos": 804,
"total_chunks": 1,
"chunks_size": 1000,
"fps": 30,
"splits": {
"train": "0:201"
},
"data_path": "data/chunk-{episode_chunk:03d}/episode_{episode_index:06d}.parquet",
"video_path": "videos/chunk-{episode_chunk:03d}/{video_key}/episode_{episode_index:06d}.mp4",
"features": {
"observation.state": {
"dtype": "float32",
"shape": [
28
],
"names": [
[
"kLeftShoulderPitch",
"kLeftShoulderRoll",
"kLeftShoulderYaw",
"kLeftElbow",
"kLeftWristRoll",
"kLeftWristPitch",
"kLeftWristYaw",
"kRightShoulderPitch",
"kRightShoulderRoll",
"kRightShoulderYaw",
"kRightElbow",
"kRightWristRoll",
"kRightWristPitch",
"kRightWristYaw",
"kLeftHandThumb0",
"kLeftHandThumb1",
"kLeftHandThumb2",
"kLeftHandMiddle0",
"kLeftHandMiddle1",
"kLeftHandIndex0",
"kLeftHandIndex1",
"kRightHandThumb0",
"kRightHandThumb1",
"kRightHandThumb2",
"kRightHandIndex0",
"kRightHandIndex1",
"kRightHandMiddle0",
"kRightHandMiddle1"
]
]
},
"action": {
"dtype": "float32",
"shape": [
28
],
"names": [
[
"kLeftShoulderPitch",
"kLeftShoulderRoll",
"kLeftShoulderYaw",
"kLeftElbow",
"kLeftWristRoll",
"kLeftWristPitch",
"kLeftWristYaw",
"kRightShoulderPitch",
"kRightShoulderRoll",
"kRightShoulderYaw",
"kRightElbow",
"kRightWristRoll",
"kRightWristPitch",
"kRightWristYaw",
"kLeftHandThumb0",
"kLeftHandThumb1",
"kLeftHandThumb2",
"kLeftHandMiddle0",
"kLeftHandMiddle1",
"kLeftHandIndex0",
"kLeftHandIndex1",
"kRightHandThumb0",
"kRightHandThumb1",
"kRightHandThumb2",
"kRightHandIndex0",
"kRightHandIndex1",
"kRightHandMiddle0",
"kRightHandMiddle1"
]
]
},
"observation.images.cam_left_high": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"observation.images.cam_right_high": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"observation.images.cam_left_wrist": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"observation.images.cam_right_wrist": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"timestamp": {
"dtype": "float32",
"shape": [
1
],
"names": null
},
"frame_index": {
"dtype": "int64",
"shape": [
1
],
"names": null
},
"episode_index": {
"dtype": "int64",
"shape": [
1
],
"names": null
},
"index": {
"dtype": "int64",
"shape": [
1
],
"names": null
},
"task_index": {
"dtype": "int64",
"shape": [
1
],
"names": null
}
}
}
```

## Citation

**BibTeX:**

```bibtex
[More Information Needed]
```

本数据集基于[LeRobot](https://github.com/huggingface/lerobot)框架构建。

## 数据集描述

- **"主页"**：[需补充更多信息]
- **"论文"**：[需补充更多信息]
- **"授权协议"**：Apache-2.0
- **"任务目标"**：将英特尔RealSense D-405相机（RealSense D-405）安装至配套收纳盒并锁紧盒盖。
- **"操作对象"**：英特尔RealSense D-405相机及其原厂完整包装（购买链接：[【淘宝】退货运费险 https://e.tb.cn/h.60YgeNsj0ZmKJD1?tk=VwPYeJGcavx tG-#22>lD 「英特尔RealSense D405近距离7~50cm高精度毫米深度相机实感摄像头」点击链接直接打开 或 直接通过淘宝搜索获取]）
- **"操作时长"**：单次操作耗时约20至40秒。
- **"录制帧率"**：30 Hz。
- **"机器人类型"**：7自由度双臂G1机器人。
- **"末端执行器"**：三指灵巧手。
- **"双臂操作"**：是。
- **"图像分辨率"**：640×480。
- **"相机布局"**：腕部安装（单目相机）+ 头部安装（双目相机）。
- **"数据内容"**：
• 机器人当前状态
• 机器人下一步动作
• 当前相机视角图像
- **"机器人初始姿态"**：每个数据条目中的首个机器人状态。
- **"物体摆放规则"**：将相机收纳盒置于机器人初始双臂垂直状态下的双臂中点位置，距离工作台朝向机器人一侧的内壁内缘30cm处；将相机放置于收纳盒右侧，盒盖放置于收纳盒左侧。
- **"相机视角"**：遵循[AVP远程操作文档（AVP Teleoperation Documentation）](https://github.com/unitreerobotics/avp_teleoperate)第5部分的指南。

- **"重要注意事项"**：
1. 由于无法精准描述空间位置，在按照[AVP远程操作文档（AVP Teleoperation Documentation）](https://github.com/unitreerobotics/avp_teleoperate)第5部分完成硬件安装后，请调整场景以尽可能匹配数据集的首帧画面。
2. 数据采集并非单次完成，不同数据条目间存在差异，请在模型训练阶段充分考虑此类变异情况。

## 数据集结构

`meta/info.json` 文件内容如下：
json
{
"codebase_version": "v2.0",
"robot_type": "Unitree_G1",
"total_episodes": 201,
"total_frames": 256253,
"total_tasks": 1,
"total_videos": 804,
"total_chunks": 1,
"chunks_size": 1000,
"fps": 30,
"splits": {
"train": "0:201"
},
"data_path": "data/chunk-{episode_chunk:03d}/episode_{episode_index:06d}.parquet",
"video_path": "videos/chunk-{episode_chunk:03d}/{video_key}/episode_{episode_index:06d}.mp4",
"features": {
"observation.state": {
"dtype": "float32",
"shape": [
28
],
"names": [
[
"kLeftShoulderPitch",
"kLeftShoulderRoll",
"kLeftShoulderYaw",
"kLeftElbow",
"kLeftWristRoll",
"kLeftWristPitch",
"kLeftWristYaw",
"kRightShoulderPitch",
"kRightShoulderRoll",
"kRightShoulderYaw",
"kRightElbow",
"kRightWristRoll",
"kRightWristPitch",
"kRightWristYaw",
"kLeftHandThumb0",
"kLeftHandThumb1",
"kLeftHandThumb2",
"kLeftHandMiddle0",
"kLeftHandMiddle1",
"kLeftHandIndex0",
"kLeftHandIndex1",
"kRightHandThumb0",
"kRightHandThumb1",
"kRightHandThumb2",
"kRightHandIndex0",
"kRightHandIndex1",
"kRightHandMiddle0",
"kRightHandMiddle1"
]
]
},
"action": {
"dtype": "float32",
"shape": [
28
],
"names": [
[
"kLeftShoulderPitch",
"kLeftShoulderRoll",
"kLeftShoulderYaw",
"kLeftElbow",
"kLeftWristRoll",
"kLeftWristPitch",
"kLeftWristYaw",
"kRightShoulderPitch",
"kRightShoulderRoll",
"kRightShoulderYaw",
"kRightElbow",
"kRightWristRoll",
"kRightWristPitch",
"kRightWristYaw",
"kLeftHandThumb0",
"kLeftHandThumb1",
"kLeftHandThumb2",
"kLeftHandMiddle0",
"kLeftHandMiddle1",
"kLeftHandIndex0",
"kLeftHandIndex1",
"kRightHandThumb0",
"kRightHandThumb1",
"kRightHandThumb2",
"kRightHandIndex0",
"kRightHandIndex1",
"kRightHandMiddle0",
"kRightHandMiddle1"
]
]
},
"observation.images.cam_left_high": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"observation.images.cam_right_high": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"observation.images.cam_left_wrist": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"observation.images.cam_right_wrist": {
"dtype": "video",
"shape": [
3,
480,
640
],
"names": [
"channels",
"height",
"width"
],
"info": {
"video.fps": 30.0,
"video.height": 480,
"video.width": 640,
"video.channels": 3,
"video.codec": "av1",
"video.pix_fmt": "yuv420p",
"video.is_depth_map": false,
"has_audio": false
}
},
"timestamp": {
"dtype": "float32",
"shape": [
1
],
"names": null
},
"frame_index": {
"dtype": "int64",
"shape": [
1
],
"names": null
},
"episode_index": {
"dtype": "int64",
"shape": [
1
],
"names": null
},
"index": {
"dtype": "int64",
"shape": [
1
],
"names": null
},
"task_index": {
"dtype": "int64",
"shape": [
1
],
"names": null
}
}
}

## 引用

**BibTeX格式：**
bibtex
[需补充更多信息]