COLMAP Wrapper

About

Colmap wrapper is a library to work with colmap projects. The purpose is the simplification to read e.g. rgb images, depth images, camera poses, sparse point clouds etc. Additionally a visualization for a colmap project is provided.

Installation

Make sure that you have a Python version >=3.8 installed.

This repository is tested on Python 3.8+ and can currently only be installed from PyPi.

pip install colmap-wrapper

Usage

Single Reconstruction

To visualize a single reconstruction from COLMAP, the following code reads all colmap elements and visualizes them. For this case an example reconstruction project is provided as shown at the top of the readme.

from colmap_wrapper.colmap import COLMAP
from colmap_wrapper.visualization import ColmapVisualization
from colmap_wrapper.data.download import Dataset

downloader = Dataset()
downloader.download_bunny_dataset()

project = COLMAP(project_path=downloader.file_path, load_images=True, image_resize=0.3)

colmap_project = project.projects

# Acess camera, images and sparse + dense point cloud
camera = colmap_project.cameras
images = colmap_project.images
sparse = colmap_project.get_sparse()
dense = colmap_project.get_dense()

# Visualize COLMAP Reconstruction
project_vs = ColmapVisualization(colmap_project)
project_vs.visualization(frustum_scale=0.7, image_type='image')

Multiple Incomplete Reconstruction

In case of an incomplete reconstruction colmap creates partial reconstructions. In this case a list of reconstructions can be called as shown below.

from colmap_wrapper.colmap import COLMAP
from colmap_wrapper.visualization import ColmapVisualization

project = COLMAP(project_path="[PATH2COLMAP_PROJECT]", load_images=True, image_resize=0.3)

# project.projects is a list containing single colmap projects
for COLMAP_MODEL in project.projects:
    project_vs = ColmapVisualization(colmap=COLMAP_MODEL)
    project_vs.visualization(frustum_scale=0.7, image_type='image')

References

• PyExifTool: A library to communicate with the ExifTool command- application. If you have trouble installing it please refer to the PyExifTool-Homepage.

# For Ubuntu users:
wget https://exiftool.org/Image-ExifTool-12.51.tar.gz
gzip -dc Image-ExifTool-12.51.tar.gz | tar -xf -
cd Image-ExifTool-12.51
perl Makefile.PL
make test
sudo make install

• To Visualize the Reconstruction on an OSM-Map the implementation from GPS-visualization-Python is used. A guide to visualize gps data can be found on Medium .