Update README.md
Browse files
README.md
CHANGED
|
@@ -1,12 +1,47 @@
|
|
| 1 |
---
|
| 2 |
-
library_name: dust3r
|
| 3 |
tags:
|
| 4 |
-
- image-to-3d
|
| 5 |
- pytorch_model_hub_mixin
|
| 6 |
- model_hub_mixin
|
|
|
|
|
|
|
| 7 |
repo_url: https://github.com/naver/dust3r
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
|
|
|
| 2 |
tags:
|
|
|
|
| 3 |
- pytorch_model_hub_mixin
|
| 4 |
- model_hub_mixin
|
| 5 |
+
- image-to-3d
|
| 6 |
+
library_name: dust3r
|
| 7 |
repo_url: https://github.com/naver/dust3r
|
| 8 |
---
|
| 9 |
|
| 10 |
+
## DUSt3R: Geometric 3D Vision Made Easy
|
| 11 |
+
|
| 12 |
+
```bibtex
|
| 13 |
+
@inproceedings{dust3r_cvpr24,
|
| 14 |
+
title={DUSt3R: Geometric 3D Vision Made Easy},
|
| 15 |
+
author={Shuzhe Wang and Vincent Leroy and Yohann Cabon and Boris Chidlovskii and Jerome Revaud},
|
| 16 |
+
booktitle = {CVPR},
|
| 17 |
+
year = {2024}
|
| 18 |
+
}
|
| 19 |
+
```
|
| 20 |
+
|
| 21 |
+
# License
|
| 22 |
+
The code is distributed under the CC BY-NC-SA 4.0 License. See [LICENSE](https://github.com/naver/dust3r/blob/main/LICENSE) for more information.
|
| 23 |
+
For the checkpoints, make sure to agree to the license of all the public training datasets and base checkpoints we used, in addition to CC-BY-NC-SA 4.0. See [section: Our Hyperparameters](https://github.com/naver/dust3r?tab=readme-ov-file#our-hyperparameters) for details.
|
| 24 |
+
|
| 25 |
+
# Model info
|
| 26 |
+
|
| 27 |
+
Gihub page: https://github.com/naver/dust3r/
|
| 28 |
+
Project page: https://dust3r.europe.naverlabs.com/
|
| 29 |
+
|
| 30 |
+
| Modelname | Training resolutions | Head | Encoder | Decoder |
|
| 31 |
+
|-------------|----------------------|------|---------|---------|
|
| 32 |
+
| DUSt3R_ViTLarge_BaseDecoder_512_dpt | 512x384, 512x336, 512x288, 512x256, 512x160 | Linear | ViT-L | ViT-B |
|
| 33 |
+
|
| 34 |
+
# How to use
|
| 35 |
+
|
| 36 |
+
First, [install dust3r](https://github.com/naver/dust3r?tab=readme-ov-file#installation).
|
| 37 |
+
To load the model:
|
| 38 |
+
|
| 39 |
+
```python
|
| 40 |
+
from dust3r.model import AsymmetricCroCo3DStereo
|
| 41 |
+
import torch
|
| 42 |
+
|
| 43 |
+
model = AsymmetricCroCo3DStereo.from_pretrained("naver/DUSt3R_ViTLarge_BaseDecoder_512_dpt")
|
| 44 |
+
|
| 45 |
+
device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
|
| 46 |
+
model.to(device)
|
| 47 |
+
```
|