ubisoft-laforge-chord / README.md

ksangk

update_files (#2)

2b61fc1 verified 22 days ago

preview code

raw

history blame contribute delete

3.47 kB

metadata

license: other
license_name: ubisoft-machine-learning-license-research-only-copyleft
license_link: LICENSE
datasets:
  - gvecchio/MatSynth

Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images

Zhi Ying*, Boxiang Rong*, Jingyu Wang, Maoyuan Xu

Official implementation of the paper "Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images".

Setup environment

Clone github repo:

git clone https://github.com/ubisoft/ubisoft-laforge-chord
cd ubisoft-laforge-chord

Install dependencies. The example below uses uv to manage the virtual environment:

# Get Python environment
uv venv --python 3.12

# On Linux/WSL
source .venv/bin/activate

# Or on Windows
.venv\Scripts\activate

# If you encounter the following error on Windows:
# File .venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system
# Run the command: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# Install dependencies
uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128
uv pip install -r requirements.txt

Agree to the model's term from here, then log in:
```
huggingface-cli login
```
(Optional) Install Gradio for running demo locally:
```
uv pip install gradio
```

Usage example

Run test:

python test.py --input-dir examples

Run the Gradio demo locally:

python demo_gradio.py

License

This project is released under the Ubisoft Machine Learning License (Research-Only - Copyleft). See the full terms in the LICENSE file.

Citation

If you find our work useful, please consider citing:

@inproceedings{ying2025chord,
    author = {Ying, Zhi and Rong, Boxiang and Wang, Jingyu and Xu, Maoyuan},
    title = {Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images},
    year = {2025},
    isbn = {9798400721373},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {https://doi.org/10.1145/3757377.3763848},
    doi = {10.1145/3757377.3763848},
    booktitle = {Proceedings of the SIGGRAPH Asia 2025 Conference Papers},
    articleno = {164},
    numpages = {11},
    keywords = {Appearance Modeling, Material Generation, Texture Synthesis, SVBRDF, Image-conditional Diffusion Models},
    series = {SA Conference Papers '25}
}