Update README.md
Browse files
README.md
CHANGED
@@ -1,3 +1,54 @@
|
|
1 |
-
---
|
2 |
-
license: apache-2.0
|
3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
license: apache-2.0
|
3 |
+
datasets:
|
4 |
+
- JayLee131/vqbet_pusht
|
5 |
+
pipeline_tag: robotics
|
6 |
+
---
|
7 |
+
# Model Card for VQ-BeT/PushT
|
8 |
+
|
9 |
+
VQ-BeT (as per [Behavior Generation with Latent Actions](https://arxiv.org/abs/2403.03181)) trained for the `PushT` environment from [gym-pusht](https://github.com/huggingface/gym-pusht).
|
10 |
+
|
11 |
+
## How to Get Started with the Model
|
12 |
+
|
13 |
+
See the [LeRobot library](https://github.com/huggingface/lerobot) (particularly the [evaluation script](https://github.com/huggingface/lerobot/blob/main/lerobot/scripts/eval.py)) for instructions on how to load and evaluate this model.
|
14 |
+
|
15 |
+
## Training Details
|
16 |
+
|
17 |
+
Trained with [LeRobot@342f429](https://github.com/huggingface/lerobot/tree/342f429f1c321a2b4501c3007b1dacba7244b469).
|
18 |
+
|
19 |
+
The model was trained using this command:
|
20 |
+
|
21 |
+
```bash
|
22 |
+
python lerobot/scripts/train.py \
|
23 |
+
policy=vqbet \
|
24 |
+
env=pusht dataset_repo_id=lerobot/pusht \
|
25 |
+
wandb.enable=true \
|
26 |
+
device=cuda
|
27 |
+
```
|
28 |
+
|
29 |
+
The training curves may be found at https://wandb.ai/jaylee0301/lerobot/runs/9r0ndphr?nw=nwuserjaylee0301.
|
30 |
+
|
31 |
+
Training VQ-BeT on PushT took about 7-8 hours to train on an Nvida A6000.
|
32 |
+
|
33 |
+
## Model Size
|
34 |
+
|
35 |
+
<blank>|Number of Parameters
|
36 |
+
-|-
|
37 |
+
RGB Encoder | 11.2M
|
38 |
+
Remaining VQ-BeT Parts | 26.3M
|
39 |
+
|
40 |
+
## Evaluation
|
41 |
+
|
42 |
+
The model was evaluated on the `PushT` environment from [gym-pusht](https://github.com/huggingface/gym-pusht). There are two evaluation metrics on a per-episode basis:
|
43 |
+
|
44 |
+
- Maximum overlap with target (seen as `eval/avg_max_reward` in the charts above). This ranges in [0, 1].
|
45 |
+
- Success: whether or not the maximum overlap is at least 95%.
|
46 |
+
|
47 |
+
Here are the metrics for 500 episodes worth of evaluation.
|
48 |
+
|
49 |
+
<blank>|Ours
|
50 |
+
-|-
|
51 |
+
Average max. overlap ratio for 500 episodes | 0.895
|
52 |
+
Success rate for 500 episodes (%) | 63.8
|
53 |
+
|
54 |
+
The results of each of the individual rollouts may be found in [eval_info.json](eval_info.json).
|