KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

IBL-NeRF

★ 43 Open GitHub ↗

Official implementation of IBL-NeRF: Image-Based Lighting Formulation of Neural Radiance Fields (Computer Graphics Forum, Pacific Graphics 2023)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# IBL-NeRF
Official implementation of <b>IBL-NeRF: Image-Based Lighting Formulation of Neural Radiance Fields (Computer Graphics Forum, Proceedings of Pacific Graphics 2023)</b>
<div style="text-align:center">
<img src="assets/teaser.png" alt="teaser image"/>
</div>

### [Project Page](https://changwoon.info/publications/IBL-NeRF) | [Paper](https://arxiv.org/abs/2210.08202) | [Data](https://drive.google.com/drive/folders/1hNcZBgHAM0SBiULJiiS1V8NGdLe4xt7j?usp=share_link)
## Overview
We propose IBL-NeRF, which decomposes the neural radiance fields (NeRF) of large-scale indoor scenes into intrinsic components.
Previous approaches for the inverse rendering of NeRF transform the implicit volume to fit the rendering pipeline of explicit geometry, and approximate the views of segmented, isolated objects with environment lighting.
In contrast, our inverse rendering extends the original NeRF formulation to capture the spatial variation of lighting within the scene volume, in addition to surface properties.
Specifically, the scenes of diverse materials are decomposed into intrinsic components for image-based rendering, namely, albedo, roughness, surface normal, irradiance, and prefiltered radiance.
All of the components are inferred as neural images from MLP, which can model large-scale general scenes.
By adopting the image-based formulation of NeRF, our approach inherits superior visual quality and multi-view consistency for synthesized images.
We demonstrate the performance on scenes with complex object layouts and light configurations, which could not be processed in any of the previous works.

<!--
## Method
### Intrinsic Decomposition
IBL-NeRF decomposes the baked radiance in NeRF into intrinsic components.
<div style="text-align:center">
<img src="assets/intrinsic_decomposition.png" alt="intrinsic decomposition"/>
</div>

### Prefiltered Radiance Fields
<div style="text-align:center">
<img src="assets/prefiltered.png" alt="illustration of prefiltered radiance fields"/>
</div>

## Applications
### Material Editing

### Object Insertion
-->
___

## Installation
### Environment Setup
We tested IBL-NeRF in Ubuntu 20.04 with RTX 3090 GPU. With proper version of CUDA toolkit, it would work on other environments.
```
git clone https://github.com/changwoonchoi/IBL-NeRF.git
cd IBL-NeRF
conda create -n IBL-NeRF python=3.8
conda activate IBL-NeRF
pip install torch==1.11.0+cu113 torchvision==0.12.0+cu113 torchaudio==0.11.0 --extra-index-url https://download.pytorch.org/whl/cu113
pip install -r requirements.txt
```

### Dataset
We provide the dataset we test in the paper.
The dataset includes rendered images with path tracer with its corresponding camera parameter.
Also, the dataset contains intrinsic components (albedo, irradiance, normal, and roughness) for evaluation.
Put the data in the directory "data/".
### Prior Loss
To impose prior loss ( $L_{\text{prior}}$ and $L_{I,\text{reg}}$ ), you need to run single-image based intrinsic decomposition algorithms.
We used Bell et al.[[Link](https://github.com/seanbell/intrinsic)] to generate the pseudo albedo and irradiance maps.
Also, we used Tinghui Zhou et al.[[Link](https://github.com/tinghuiz/learn-reflectance)] for the additional results in the supplementary material.
You can run the algorithm yourself, but we provide the results of the algorithm in the dataset.

## Training IBL-NeRF
To train IBL-NeRF in the <span style="font-variant:small-caps;">Kitchen</span> scene, run the scripts below.
```
cd src
python train.py --config ../configs/IBL-NeRF/kitchen.txt
```

## Evaluation
To infer and measure error metrics on test set, run the scripts below.
This code will automatically find the latest checkpoint in the log directory and render test images.
```
python test.py --config ../configs/IBL-NeRF/kitchen/IBL-NeRF.txt
python evaluation/calculate_metrics.py --gt ../data/IBL-NeRF/kitchen --pred ../logs_eval/IBL-NeRF/kitchen/IBL-NeRF/testset_119999 --dataset_type mitsuba
```

## Material Editing
```
python test.py --config ../configs/IBL-NeRF/kitchen/edit_intrinsic.txt
```

## Object Insertion
```
python test.py --config ../configs/IBL-NeRF/living-room-2/object_insert.txt
```

## Citation
Cite as below if you find this paper and repository are helpful to you:
```
@article{choi2022ibl,
  title={IBL-NeRF: Image-Based Lighting Formulation of Neural Radiance Fields},
  author={Choi, Changwoon and Kim, Juhyeon and Kim, Young Min},
  journal={arXiv preprint arXiv:2210.08202},
  year={2022}
}
```

IBL-NeRF

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README