gs-relight

Official Code Release for SIGGRAPH Asia 2024 Paper: GS^3: Efficient Relighting with Triple Gaussian Splatting

https://github.com/gsrelight/gs-relight

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
Last synced: 6 months ago · JSON representation ·

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
Created over 1 year ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

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

[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

Dockerfile docker
  • nvidia/cuda 12.4.0-devel-ubuntu22.04 build
requirements.txt pypi
  • gsplat ==1.1.1
  • numpy ==1.26.3
  • opencv-python ==4.9.0.80
  • plyfile ==0.8.1
  • submodules *
  • tensorboard ==2.16.2
  • tqdm *
submodules/diff-gaussian-rasterization_light/setup.py pypi
submodules/simple-knn/setup.py pypi