Project Page | Video | Paper
PyTorch implementation of automatic integration.
AutoInt: Automatic Integration for Fast Neural Volume Rendering
David B. Lindell*,
Julien N. P. Martel*,
Gordon Wetzstein
Stanford University
*denotes equal contribution
in CVPR 2021
To get started quickly, we provide a colab link above. Otherwise, you can clone this repo and follow the below instructions.
To setup a conda environment, download example training data, begin the training process, and launch Tensorboard:
conda env create -f environment.yml
conda activate autoint
cd experiment_scripts
python train_1d_integral.py
tensorboard --logdir=../logs --port=6006
This example will fit a grad network to a 1D signal and evaluate the integral. You can monitor the training in your browser at localhost:6006
. You can also train a network on the sparse tomography problem presented in the paper with python train_sparse_tomography.py
.
Automatic integration can be used to learn closed form solutions to the volume rendering equation, which is an integral equation accumulates transmittance and emittance along rays to render an image. While conventional neural renderers require hundreds of samples along each ray to evaluate these integrals (and hence hundreds of costly forward passes through a network), AutoInt allows evaluating these integrals far fewer forward passes.
To run AutoInt for neural rendering, first set up the conda environment with
conda env create -f environment.yml
conda activate autoint
Then, download the datasets to the data
folder. We allow training on any of three datasets. The synthetic Blender data from NeRF and the LLFF scenes are hosted here. The DeepVoxels data are hosted here.
Finally, use the provided config files in the experiment_scripts/configs
folder to train on these datasets. For example, to train on a NeRF Blender dataset, run the following
python train_autoint_radiance_field.py --config ./configs/config_blender_tiny.ini
tensorboard --logdir=../logs/ --port=6006
This will train a small, low-resolution scene. To train scenes at high-resolution (requires a few days of training time), use the config_blender.ini
, config_deepvoxels.ini
, or config_llff.ini
config files.
Rendering from a trained model can be done with the following command.
python train_autoint_radiance_field.py --config /path/to/config/file --render_model ../logs/path/to/log/directory <epoch number> --render_output /path/to/output/folder
Here, the --render_model
command indicates the log directory where the code saves the models and checkpoints. For example, this would be ../logs/blender_lego
for the default Blender dataset. Then, the epoch number can be found by looking at numbers of the the saved checkpoint filenames in ../logs/blender_lego/checkpoints/
. Finally, --render_output
should specify a folder where the output rendered images will be generated.
@inproceedings{autoint2021,
title={AutoInt: Automatic Integration for Fast Neural Volume Rendering},
author={David B. Lindell and Julien N. P. Martel and Gordon Wetzstein},
year={2021},
booktitle={Proc. CVPR},
}