Create README.md

README.md

@@ -0,0 +1,52 @@
+---
+license: cc-by-nc-4.0
+pipeline_tag: image-to-3d
+---
+
+# GS-ROR<sup>2</sup>: Bidirectional-guided 3DGS and SDF for Reflective Object Relighting and Reconstruction
+
+This repository contains the official checkpoints and results for **GS-ROR<sup>2</sup>**, a novel method presented in the paper [GS-ROR<sup>2</sup>: Bidirectional-guided 3DGS and SDF for Reflective Object Relighting and Reconstruction](https://arxiv.org/abs/2406.18544). This work will be presented at ACM TOG 2025.
+
+GS-ROR<sup>2</sup> significantly advances 3D Gaussian splatting (3DGS) for inverse rendering, enabling the creation of high-quality relightable 3D assets.
+
+<p align="middle">
+<img src="https://nk-cs-zzl.github.io/projects/gsror/assets/images/angel_relit.gif" width="30%"/><img src="https://nk-cs-zzl.github.io/projects/gsror/assets/images/tbell_relit.gif" width="30%"/><img src="https://nk-cs-zzl.github.io/projects/gsror/assets/images/toaster_relit.gif" width="30%"/>
+</p>
+<p align="middle">
+<img src="https://nk-cs-zzl.github.io/projects/gsror/assets/images/angel_mesh.gif" width="30%"/><img src="https://nk-cs-zzl.github.io/projects/gsror/assets/images/tbell_mesh.gif" width="30%"/><img src="https://nk-cs-zzl.github.io/projects/gsror/assets/images/toaster_mesh.gif" width="30%"/>
+</p>
+
+## Links
+-   📄 **Paper**: [GS-ROR<sup>2</sup>: Bidirectional-guided 3DGS and SDF for Reflective Object Relighting and Reconstruction](https://arxiv.org/abs/2406.18544)
+-   🌐 **Project Page**: [https://nk-cs-zzl.github.io/projects/dsdf/index.html](https://nk-cs-zzl.github.io/projects/gsror/index.html)
+-   💻 **GitHub Repository**: [https://github.com/NK-CS-ZZL/DiscretizedSDF](https://github.com/NK-CS-ZZL/GS-ROR)
+
+## Usage
+For detailed installation instructions, environment setup, and information on training and evaluation, please refer to the [official GitHub repository](https://github.com/NK-CS-ZZL/GS-ROR).
+
+To run a quick relighting video demo with the provided checkpoints:
+
+1.  Clone the repository:
+    ```bash
+    git clone https://github.com/NK-CS-ZZL/GS-ROR.git
+    cd GS-ROR
+    ```
+2.  Follow the installation steps on the [GitHub repository's "Dependencies and Installation" section](https://github.com/NK-CS-ZZL/GS-ROR#dependencies-and-installation) to set up the environment and dependencies.
+3.  Download pretrained models (e.g., from [HuggingFace](https://huggingface.co/lalala125/GSROR) as mentioned in the GitHub README) and place them in the `pretrained` folder.
+4.  Run the demo script:
+    ```bash
+    sh demo.sh
+    ```
+
+## Citation
+If you find our work useful for your research, please consider citing our paper:
+```bibtex
+@inproceedings{zhu_2025_gsror,
+   title={GS-ROR^2: Bidirectional-guided 3DGS and SDF for Reflective Object Relighting and Reconstruction},
+   author={Zhu, Zuo-Liang and Yang, Jian and Wang, Beibei},
+   journal = {ACM Transactions on Graphics (TOG)},
+   year={2025}，
+   publisher = {ACM},
+   doi={10.1145/3759248},
+}
+```