Ubisoft/ubisoft-laforge-chord

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

1. Clone github repo:

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

2. 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
   

3. Agree to the model's term from here, then log in:

   huggingface-cli login
   

4. (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}
}

© [2025] Ubisoft Entertainment. All Rights Reserved.