Improve model card: Add pipeline tag, abstract, usage example, and links (#1)
Browse files- Improve model card: Add pipeline tag, abstract, usage example, and links (8250e67a278f8b187638a2b1f9999e6ac9372990)
Co-authored-by: Niels Rogge <[email protected]>
README.md
CHANGED
@@ -1,9 +1,52 @@
|
|
1 |
---
|
2 |
license: cc-by-nc-4.0
|
|
|
3 |
---
|
4 |
|
5 |
-
|
6 |
|
7 |
-
Model
|
8 |
|
9 |
-
Project page
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
---
|
2 |
license: cc-by-nc-4.0
|
3 |
+
pipeline_tag: depth-estimation
|
4 |
---
|
5 |
|
6 |
+
# Manipulation as in Simulation: Enabling Accurate Geometry Perception in Robots
|
7 |
|
8 |
+
This repository contains the Camera Depth Model (CDM) introduced in the paper [Manipulation as in Simulation: Enabling Accurate Geometry Perception in Robots](https://huggingface.co/papers/2509.02530).
|
9 |
|
10 |
+
**Project page**: https://manipulation-as-in-simulation.github.io/
|
11 |
+
**Code repository**: https://github.com/ByteDance-Seed/manip-as-in-sim-suite
|
12 |
+
|
13 |
+
## Abstract
|
14 |
+
Modern robotic manipulation primarily relies on visual observations in a 2D color space for skill learning but suffers from poor generalization. In contrast, humans, living in a 3D world, depend more on physical properties-such as distance, size, and shape-than on texture when interacting with objects. Since such 3D geometric information can be acquired from widely available depth cameras, it appears feasible to endow robots with similar perceptual capabilities. Our pilot study found that using depth cameras for manipulation is challenging, primarily due to their limited accuracy and susceptibility to various types of noise. In this work, we propose Camera Depth Models (CDMs) as a simple plugin on daily-use depth cameras, which take RGB images and raw depth signals as input and output denoised, accurate metric depth. To achieve this, we develop a neural data engine that generates high-quality paired data from simulation by modeling a depth camera's noise pattern. Our results show that CDMs achieve nearly simulation-level accuracy in depth prediction, effectively bridging the sim-to-real gap for manipulation tasks. Notably, our experiments demonstrate, for the first time, that a policy trained on raw simulated depth, without the need for adding noise or real-world fine-tuning, generalizes seamlessly to real-world robots on two challenging long-horizon tasks involving articulated, reflective, and slender objects, with little to no performance degradation. We hope our findings will inspire future research in utilizing simulation data and 3D information in general robot policies.
|
15 |
+
|
16 |
+
## Usage (Camera Depth Models - CDM)
|
17 |
+
|
18 |
+
To run depth inference on RGB-D camera data, follow these steps from the [CDM inference guide](https://github.com/ByteDance-Seed/manip-as-in-sim-suite/tree/main/cdm) in the GitHub repository:
|
19 |
+
|
20 |
+
First, clone the repository and install the CDM package:
|
21 |
+
|
22 |
+
```bash
|
23 |
+
git clone https://github.com/ByteDance-Seed/manip-as-in-sim-suite.git
|
24 |
+
cd manip-as-in-sim-suite/cdm
|
25 |
+
pip install -e .
|
26 |
+
```
|
27 |
+
|
28 |
+
Then, navigate to the `cdm` directory and run inference using `infer.py`:
|
29 |
+
|
30 |
+
```bash
|
31 |
+
cd cdm
|
32 |
+
python infer.py \
|
33 |
+
--encoder vitl \
|
34 |
+
--model-path /path/to/model.pth \
|
35 |
+
--rgb-image /path/to/rgb.jpg \
|
36 |
+
--depth-image /path/to/depth.png \
|
37 |
+
--output result.png
|
38 |
+
```
|
39 |
+
|
40 |
+
## Citation
|
41 |
+
If you use this work in your research, please cite:
|
42 |
+
|
43 |
+
```bibtex
|
44 |
+
@article{liu2025manipulation,
|
45 |
+
title={Manipulation as in Simulation: Enabling Accurate Geometry Perception in Robots},
|
46 |
+
author={Liu, Minghuan and Zhu, Zhengbang and Han, Xiaoshen and Hu, Peng and Lin, Haotong and
|
47 |
+
Li, Xinyao and Chen, Jingxiao and Xu, Jiafeng and Yang, Yichu and Lin, Yunfeng and
|
48 |
+
Li, Xinghang and Yu, Yong and Zhang, Weinan and Kong, Tao and Kang, Bingyi},
|
49 |
+
journal={arXiv preprint},
|
50 |
+
year={2025}
|
51 |
+
}
|
52 |
+
```
|