This is a guide for building and running instant-ngp with custom datasets. Code based on instant-ngp-helper with updated directions, protocol, and dependencies.
Follow these steps in order -- it matters.
- Install Visual Studio Community 2019. Be sure to include
Desktop Development with C++
. - Install CUDA Toolkit 11.6
- Install Anaconda Prompt (Python 3.9)
- Install Git
- Install OptiX 7.4.0 SDK
- Install Vulkan SDK
- Add OptiX_INSTALL_DIR to System variables with the value path
C:\ProgramData\NVIDIA Corporation\OptiX SDK 7.4.0
- Open
Anaconda Prompt
andcd
to your desired install directory. - Type:
git clone --recursive https://github.com/ethanproia/instant-ngp-simple
cd
into...\instant-ngp-simple
and run:
python install.py
- When install and build are finished, run:
pip install opencv-python
- Add
COLMAP
folder to PATH:C:\Users\[YOUR USERNAME]\...\instant-ngp-simple\COLMAP
instant-ngp-helper can process both video and image still sequences into NeRFs.
- Navigate to your
...\instant-ngp-simple\instant-ngp\tmp
directory, make a new folder calledimages
, and load your image stills dataset into theimages
folder. - In a fresh
Anaconda Prompt
,cd
into yourinstant-ngp-simple
directory and run:
python run.py
- Click the
instant-ngp (images)
button in the UI, navigate back to the Anaconda Prompt window and follow the COLMAP instructions. (Don't forget to add the COLMAP folder to PATH as shown in Step 12 or you'll get a COLMAP error.) - When COLMAP finishes processing and says
done
, go back to the UI and clickinstant-ngp NeRF
.
- Navigate to your
...\instant-ngp-simple\instant-ngp\tmp
directory and just drop your video file in the folder. - In a fresh
Anaconda Prompt
,cd
into yourinstant-ngp-simple
directory and run:
python run.py
- Click the
instant-ngp (videos)
button in the UI, navigate back to the Anaconda Prompt window and follow the ffmpeg and COLMAP instructions. (Don't forget to add the COLMAP folder to PATH as shown in Step 12 or you'll get a COLMAP error.) - When COLMAP finishes processing and says
done
, go back to the UI and clickinstant-ngp NeRF
.
Follow along with my guided video tutorial. (Coming soon)
- Copy all files from inside any of the sample folders into
...\instant-ngp-simple\instant-ngp\tmp
- Open an
Anaconda Prompt
andcd
into...\instant-ngp-simple\
and run:
python run.py
- In the UI that opens, click
instant-ngp (photos)
, which will load the dataset, open the testbed.exe, and being training the NeRF.