Add model card, CC BY-NC 4.0 license, and checksums
Browse files- LICENSE +12 -0
- README.md +78 -0
- SHA256SUMS +2 -0
LICENSE
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
MatLat Pretrained Checkpoint License
|
| 2 |
+
|
| 3 |
+
The MatLat checkpoint weights in this repository are licensed under the
|
| 4 |
+
Creative Commons Attribution-NonCommercial 4.0 International License
|
| 5 |
+
(CC BY-NC 4.0).
|
| 6 |
+
|
| 7 |
+
License deed and legal code:
|
| 8 |
+
https://creativecommons.org/licenses/by-nc/4.0/
|
| 9 |
+
|
| 10 |
+
This license applies to the MatLat checkpoint weights and repository-authored
|
| 11 |
+
release metadata. It does not relicense third-party software, model weights,
|
| 12 |
+
or other dependencies used by the MatLat codebase.
|
README.md
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
library_name: pytorch
|
| 3 |
+
license: cc-by-nc-4.0
|
| 4 |
+
tags:
|
| 5 |
+
- pbr
|
| 6 |
+
- texture-generation
|
| 7 |
+
- material-generation
|
| 8 |
+
- 3d
|
| 9 |
+
- matlat
|
| 10 |
+
---
|
| 11 |
+
|
| 12 |
+
# MatLat Pretrained Checkpoints
|
| 13 |
+
|
| 14 |
+
Pretrained submission-version checkpoints for
|
| 15 |
+
[MatLat: Material Latent Space for PBR Texture Generation](https://arxiv.org/abs/2512.17302).
|
| 16 |
+
|
| 17 |
+
- `matvae_v.ours.pt`: MatVAE material autoencoder checkpoint (`global_step=200000`).
|
| 18 |
+
- `matdiff_v.ours.safetensors`: MatDiff text- and geometry-conditioned diffusion checkpoint.
|
| 19 |
+
|
| 20 |
+
Use them with the [official code](https://github.com/32V/mcgen).
|
| 21 |
+
|
| 22 |
+
## Download
|
| 23 |
+
|
| 24 |
+
```bash
|
| 25 |
+
mkdir -p checkpoints
|
| 26 |
+
|
| 27 |
+
hf download 32V/MatLat \
|
| 28 |
+
matvae_v.ours.pt \
|
| 29 |
+
matdiff_v.ours.safetensors \
|
| 30 |
+
--revision v1.0.0 \
|
| 31 |
+
--local-dir checkpoints
|
| 32 |
+
```
|
| 33 |
+
|
| 34 |
+
## Inference
|
| 35 |
+
|
| 36 |
+
Run from the root of the MatLat code repository:
|
| 37 |
+
|
| 38 |
+
```bash
|
| 39 |
+
python inference.py \
|
| 40 |
+
--config configs/submission/matdiff_v.ours.yaml \
|
| 41 |
+
--weights checkpoints/matdiff_v.ours.safetensors \
|
| 42 |
+
--mesh assets/motorcycle_cafe_racer/motorcycle_cafe_racer.obj \
|
| 43 |
+
--prompt "a matte olive green cafe racer motorcycle with brushed steel parts" \
|
| 44 |
+
--guidance 5.0 \
|
| 45 |
+
--steps 30 \
|
| 46 |
+
--seed 42 \
|
| 47 |
+
--precision bf16 \
|
| 48 |
+
--out outputs/demo
|
| 49 |
+
```
|
| 50 |
+
|
| 51 |
+
The MatVAE path and submission camera directions are selected by
|
| 52 |
+
`configs/submission/matdiff_v.ours.yaml`.
|
| 53 |
+
|
| 54 |
+
## License
|
| 55 |
+
|
| 56 |
+
The MatLat checkpoint weights are released under the
|
| 57 |
+
[Creative Commons Attribution-NonCommercial 4.0 International License](https://creativecommons.org/licenses/by-nc/4.0/)
|
| 58 |
+
(CC BY-NC 4.0). The license permits sharing and adaptation with appropriate
|
| 59 |
+
attribution for non-commercial purposes. It does not relicense third-party
|
| 60 |
+
software or model dependencies used by the official code.
|
| 61 |
+
|
| 62 |
+
## File Integrity
|
| 63 |
+
|
| 64 |
+
```text
|
| 65 |
+
f2c0d886823d7f11fe97220503ce08069e7c1b84915b27597a198bdce307e1e9 matvae_v.ours.pt
|
| 66 |
+
4f464112834f3a3d621cb780078e341026a62f700cec04ad7a20bc2d414dbb43 matdiff_v.ours.safetensors
|
| 67 |
+
```
|
| 68 |
+
|
| 69 |
+
## Citation
|
| 70 |
+
|
| 71 |
+
```bibtex
|
| 72 |
+
@inproceedings{yeo2026matlat,
|
| 73 |
+
title = {MatLat: Material Latent Space for PBR Texture Generation},
|
| 74 |
+
author = {Yeo, Kyeongmin and Min, Yunhong and Kim, Jaihoon and Sung, Minhyuk},
|
| 75 |
+
booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
|
| 76 |
+
year = {2026},
|
| 77 |
+
}
|
| 78 |
+
```
|
SHA256SUMS
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
f2c0d886823d7f11fe97220503ce08069e7c1b84915b27597a198bdce307e1e9 matvae_v.ours.pt
|
| 2 |
+
4f464112834f3a3d621cb780078e341026a62f700cec04ad7a20bc2d414dbb43 matdiff_v.ours.safetensors
|