gs-relight
Official Code Release for SIGGRAPH Asia 2024 Paper: GS^3: Efficient Relighting with Triple Gaussian Splatting
Science Score: 54.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: arxiv.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.5%) to scientific vocabulary
Repository
Official Code Release for SIGGRAPH Asia 2024 Paper: GS^3: Efficient Relighting with Triple Gaussian Splatting
Basic Info
- Host: GitHub
- Owner: gsrelight
- License: gpl-3.0
- Language: Python
- Default Branch: main
- Size: 8.72 MB
Statistics
- Stars: 125
- Watchers: 5
- Forks: 13
- Open Issues: 1
- Releases: 0
Metadata Files
README.md
GS^3: Efficient Relighting with Triple Gaussian Splatting
Zoubin Bi · Yixin Zeng · Chong Zeng · Fan Pei · Xiang Feng · Kun Zhou · Hongzhi Wu
SIGGRAPH Asia 2024 Conference Papers
Project Page
|
Paper
|
arXiv
|
Data
We present a spatial and angular Gaussian based representation and a triple splatting process, for real-time, high-quality novel lighting-and-view synthesis from multi-view point-lit input images.
Setup
Environment
Conda
bash
conda create --name gs3 python=3.10 pytorch==2.4.1 torchvision==0.19.1 pytorch-cuda=12.4 cuda-toolkit=12.4 cuda-cudart=12.4 -c pytorch -c "nvidia/label/cuda-12.4.0"
conda activate gs3
pip install ninja # speedup torch cuda extensions compilation
pip install -r requirements.txt
Docker
We also provide a docker container.
You can use our pre-built docker image.
bash
docker run -it --gpus all --rm iamncj/gs3:241002
Or you can build your own docker image.
bash
docker build -t gs3:latest .
Usage
We provide a few sample scripts from our paper.
Train
For real captured scenes, please use --cam_opt and --pl_opt to enable camera pose and light optimization.
bash
bash real_train.sh # real captured scenes
bash syn_train.sh # synthetic scenes
Test
For real captured scenes, we provide --valid and corresponding .json file to render a circle view. If you are going to run the test set of real captured scenes, please remember to add --opt_pose to use the calibrated poses.
bash
bash real_render.sh # real captured scenes
bash syn_render.sh # synthetic scenes
Data
We release our data and pretrained models at huggingface.
Note: For blender scene rendering, we use the script from NRHints. For pre-captured scene rendering, we use Asuna.
You can download the data by running the following command:
bash
pip install huggingface_hub[hf_transfer]
HF_HUB_ENABLE_HF_TRANSFER=1 huggingface-cli download --repo-type dataset gsrelight/gsrelight-data --local-dir /path/to/data
Citation
Cite as below if you find this repository is helpful to your project:
@inproceedings{bi2024rgs,
title = {GS\textsuperscript{3}: Efficient Relighting with Triple Gaussian Splatting},
author = {Zoubin Bi and Yixin Zeng and Chong Zeng and Fan Pei and Xiang Feng and Kun Zhou and Hongzhi Wu},
booktitle = {SIGGRAPH Asia 2024 Conference Papers},
year = {2024}
}
Some of our dataset are borrowed from NRHints. Please also cite NRHints if you use those data.
Acknowledgments
We have intensively borrow codes from gaussian splatting and gsplat. We also use tiny-cuda-nn for it's efficient MLP implementation. Many thanks to the authors for sharing their codes.
Owner
- Name: GS^3
- Login: gsrelight
- Kind: organization
- Location: China
- Website: https://gsrelight.github.io/
- Repositories: 1
- Profile: https://github.com/gsrelight
[SIGGRAPH Asia 2024] GS^3: Efficient Relighting with Triple Gaussian Splatting
Citation (CITATION.cff)
cff-version: 1.2.0
message: "Cite as below if you find this repository is helpful to your project"
url: "https://github.com/gsrelight/gs-relight"
preferred-citation:
type: conference-paper
authors:
- family-names: "Bi"
given-names: "Zoubin"
- family-names: "Zeng"
given-names: "Yizin"
- family-names: "Zeng"
given-names: "Chong"
- family-names: "Pei"
given-names: "Fan"
- family-names: "Feng"
given-names: "Xiang"
- family-names: "Zhou"
given-names: "Kun"
- family-names: "Wu"
given-names: "Hongzhi"
doi: "10.1145/3680528.3687576"
title: "GS^3: Efficient Relighting with Triple Gaussian Splatting"
booktitle: "ACM SIGGRAPH Asia 2024 Conference Papers"
year: 2024
GitHub Events
Total
- Issues event: 18
- Watch event: 147
- Issue comment event: 16
- Push event: 1
- Public event: 1
- Pull request event: 2
- Fork event: 15
Last Year
- Issues event: 18
- Watch event: 147
- Issue comment event: 16
- Push event: 1
- Public event: 1
- Pull request event: 2
- Fork event: 15
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 1
- Total pull requests: 0
- Average time to close issues: 2 days
- Average time to close pull requests: N/A
- Total issue authors: 1
- Total pull request authors: 0
- Average comments per issue: 1.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 0
- Average time to close issues: 2 days
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 1.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- HarryPeverell (6)
- limacv (1)
- RaymondJiangkw (1)
Pull Request Authors
- zyx45889 (1)
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- nvidia/cuda 12.4.0-devel-ubuntu22.04 build
- gsplat ==1.1.1
- numpy ==1.26.3
- opencv-python ==4.9.0.80
- plyfile ==0.8.1
- submodules *
- tensorboard ==2.16.2
- tqdm *