UBTECH-Robotics/challenge2026_dataset

# Challenge 2026 Dataset

This dataset provides training/evaluation data for the 2026 Global Humanoid Robot Challenge Simulation Competition.

**Data Format**: LeRobot v2.1

## Directory Structure

```
Packing_box/box_closing_001/ - Carton Packing (Dual-arm Coordination)
```

## Dataset Overview

- **Carton Packing (Dual-arm Coordination)**
- `box_closing_001`: 50 episodes

## Data Format

Each dataset contains multiple episodes stored in Parquet format:

```
{dataset_name}/data/chunk-000/episode_XXXXXX.parquet
```

- Dataset ID format: `{action}_{number}` (e.g., `box_closing_001`)
- Episode filename: `episode_{6-digit number}.parquet` (zero-padded)

Field definitions can be found in the main project at `lerobot/common/policies/utils.py` under observation/action definitions.

## Hugging Face Upload/Download

### Method 1: Hugging Face CLI

```bash
# Install HF CLI
powershell -ExecutionPolicy ByPass -c "irm https://hf.co/cli/install.ps1 | iex"

# Login
hf auth login

# Upload
hf upload UBTECH-Robotics/challenge2026_dataset .

# Download
hf download UBTECH-Robotics/challenge2026_dataset
```

### Method 2: Python

```python
from huggingface_hub import login, upload_folder, snapshot_download

# Login
login()

# Upload
upload_folder(
folder_path=".",
repo_id="UBTECH-Robotics/challenge2026_dataset",
repo_type="dataset"
)

# Download
snapshot_download(
repo_id="UBTECH-Robotics/challenge2026_dataset",
repo_type="dataset"
)
```

### Method 3: Git + Git-XET

```bash
# Install git-xet
git xet install

# Clone (HTTPS)
git clone https://huggingface.co/UBTECH-Robotics/challenge2026_dataset
cd challenge2026_dataset

# Push
git push

# Or use SSH
git clone [e-mail]:UBTECH-Robotics/challenge2026_dataset
```

## Dataset Naming Convention

| Level | Format | Example |
|-------|--------|---------|
| Task | / | `Packing_box` |
| Dataset Directory | `{action}_{number}` | `box_closing_001/`, `box_closing_002/` |
| Episode File | `episode_{6-digit number}.parquet` | `episode_000000.parquet` |

When adding new datasets, increment the number sequentially (e.g., `_001`, `_002`, `_003`).

# 2026挑战赛数据集

本数据集为2026全球人形机器人挑战赛仿真赛事提供训练与评估数据。

**数据格式**：LeRobot v2.1

## 目录结构

Packing_box/box_closing_001/ - 纸箱封装（双臂协作任务）

## 数据集概览
- **纸箱封装（双臂协作）**
- `box_closing_001`：共50个回合数据

## 数据格式
每个数据集包含多个以Parquet格式存储的回合数据：

{dataset_name}/data/chunk-000/episode_XXXXXX.parquet

- 数据集ID格式：`{action}_{number}`（例如`box_closing_001`）
- 回合文件名格式：`episode_{6位数字}.parquet`（不足位数时补零）

字段定义可在主项目的`lerobot/common/policies/utils.py`文件中查看，该文件包含观测与动作的相关定义。

## Hugging Face 上传与下载
### 方法1：Hugging Face命令行工具
bash
# 安装HF命令行工具
powershell -ExecutionPolicy ByPass -c "irm https://hf.co/cli/install.ps1 | iex"

# 登录账号
hf auth login

# 上传数据集
hf upload UBTECH-Robotics/challenge2026_dataset .

# 下载数据集
hf download UBTECH-Robotics/challenge2026_dataset

### 方法2：Python代码
python
from huggingface_hub import login, upload_folder, snapshot_download

# 登录账号
login()

# 上传数据集
upload_folder(
folder_path=".",
repo_id="UBTECH-Robotics/challenge2026_dataset",
repo_type="dataset"
)

# 下载数据集
snapshot_download(
repo_id="UBTECH-Robotics/challenge2026_dataset",
repo_type="dataset"
)

### 方法3：Git + Git-XET
bash
# 安装git-xet工具
git xet install

# 克隆仓库（HTTPS方式）
git clone https://huggingface.co/UBTECH-Robotics/challenge2026_dataset
cd challenge2026_dataset

# 推送更新
git push

# 或使用SSH方式克隆
git clone [e-mail]:UBTECH-Robotics/challenge2026_dataset

## 数据集命名规范
| 层级 | 格式 | 示例 |
|-------|--------|---------|
| 任务 | / | `Packing_box` |
| 数据集目录 | `{action}_{number}` | `box_closing_001/`、`box_closing_002/` |
| 回合文件 | `episode_{6位数字}.parquet` | `episode_000000.parquet` |

新增数据集时，请按顺序递增编号（例如`_001`、`_002`、`_003`）。