Skip to content

Repository files navigation

Stable-NeRF

This repository contains the code for the research project Stable NeRF. The project aims use 2D priors from Stable Diffusion and the learned 3D forward map from NeRF to perform generalizable novel view synthesis.

Contributors: Emre Arslan (earslan25), Chia-Hong Hsu (swimmincatt35), Daniel Cho (hypochoco)

Current Progress

Our initial proposal and current report with results can be found in the reports folder.

Conda Env Notes:

  • Currently, directly creating from the environment.yml file is not working or is too slow. Instead, create a new environment with python=3.8 and install the packages manually.
  • To install the packages manually, run the following commands:
  1. When using oscar, run these lines first.
module purge
module load miniconda3/23.11.0s
source /oscar/runtime/software/external/miniconda3/23.11.0/etc/profile.d/conda.sh
module load cuda/11.8.0-lpttyok
  1. Then, run the following lines.
conda create -n stable_nerf python=3.8
conda activate stable_nerf
conda install pytorch==2.1.2 torchvision==0.16.2 torchaudio==2.1.2 pytorch-cuda=11.8 -c pytorch -c nvidia
pip install -r requirements.txt
pip install submodules/raymarching
  1. Download datasets. They can also be downloaded by running the Jupyter notebooks in the datasets folder.
curl https://cseweb.ucsd.edu//~viscomp/projects/LF/papers/ECCV20/nerf/tiny_nerf_data.npz -o datasets/nerf/tiny_nerf_data.npz

Datasets

  • Original NERF dataset (link)
  • Objaverse (link)

Initially, we used a synthetic dataset to assess our method's performance. Given that baseline, we will attempt to extend our approach to generalize to real world views. Our method can benefit from most multiview datasets as we only need 2 views per scene.

TODO

  • Implement argument parser to handle different configurations
  • Integrate per-pixel features from encoded images into NeRF
  • Distributed training (current Hugging Face accelerate implementation is not compatible with the code format and tiny-cuda-nn)

Credits

We would like to thank the following repositories for their code and inspiration:

  • torch-ngp by Jiaxiang Tang (link)
  • IP-Adapter by Hu Ye, Jun Zhang, Sibo Liu, Xiao Han, Wei Yang (link)

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages