ubisoft-laforge-chord / README.md

ksangk

update demo url

b347da5 verified 28 days ago

preview code

raw

history blame

3.09 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:

@misc{ying2025chord,
    title={Chord: Chain of Rendering Decomposition for PBR Material Estimation from Generated Texture Images}, 
    author={Zhi Ying and Boxiang Rong and Jingyu Wang and Maoyuan Xu},
    year={2025},
    eprint={2509.09952},
    archivePrefix={arXiv},
    primaryClass={cs.GR},
    url={https://arxiv.org/abs/2509.09952}, 
}