Blender addon to inspect and preprocess COLMAP data for Neuralangelo (CVPR 2023). The addon allows you to inspect the COLMAP poses, check the sparse reconstruction overlaid with RGB images, and export the bounding regions for Neuralangelo.

First clone the code to a local directory.

cd /path/to/dir
git clone [email protected]:mli0603/BlenderNeuralangelo.git

Please follow the instructions to obtain COLMAP results. Alternatively, an example is provided in the folder toy_example.

If COLMAP instructions are followed correctly, a folder structure of the following should be expected:

|__ dense (or your customized work directory)
    |__ images (folder of undistorted images)
    |__ sparse (folder of sparse reconstruction results)
    |__ run-colmap-geometric.sh
    |__ run-colmap-photometric.sh

You can directly run Blender without worrying installation by:

./blender --python PATH_TO_BlenderNeuralangelo/start_blender_with_addon.py

Replace PATH_TO_BlenderNeuralangelo with your path to BlenderNeuralangelo.

Installing as a Blender Addon avoids re-installation after quitting blender. To install as an Addon:

Alternatively, the code can be directly run as follows:

After quitting Blender, this step must repeat.

After installation, the BlenderNeuralangelo panel can be located on the right side or press N on the keyboard.

COLMAP can be loaded by providing the path to the COLMAP work directory. The images, camera parameters and sparse reconstruction results are loaded.

COLMAP data can be inspected qualitatively by looking at the RGB, sparse reconstruction and pose results.

A graphics interface is provided to define the region of interest for Neuralangelo as a form of bounding box. Points outside the region of interest can be cropped.

Neuralangelo and prior works ¹²³ on neural surface reconstruction often assumes a spherical region of interest. This addon generates a bounding sphere and exports the scene parameters (intrinsics, poses, bounding sphere) following the Instant NGP format.