COLMAP

Overview

COLMAP is a general-purpose Structure-from-Motion (SfM) and Multi-View Stereo (MVS) pipeline with several features for the reconstruction of ordered and unordered image collections.

Version 3.9 & 3.10-dev are installed on the CSF, via a singularity/apptainer image.

Restrictions on use

The COLMAP library is licensed under the new BSD license and is freely available on the CSF, please refer to licence for more information – LICENCE

Set up procedure

We now recommend loading modulefiles within your jobscript so that you have a full record of how the job was run. See the example jobscript below for how to do this. Alternatively, you may load modulefiles on the login node and let the job inherit these settings.

Load one of the following modulefiles:

module load apps/singularity/colmap/3.9
module load apps/singularity/colmap/3.10

Running the application

Please do not run COLMAP on the login node. COLMAP can run on either the CPU or GPU. The GPU version is generally preferred because it has a custom feature detection mode that can produce higher quality features.

GPU Job

#!/bin/bash --login

#$ -cwd
#$ -pe smp.pe 8
#$ -l v100

DATASET_PATH="/path/to/dataset"

module load apps/singularity/colmap/3.10
colmap automatic_reconstructor \
  --workspace_path "${DATASET_PATH}" \
  --image_path "${DATASET_PATH}/images" \
  --num_threads ${NSLOTS}

Submit the jobscript using:

qsub scriptname

where scriptname is the name of your jobscript.

Further information

Updates

None.

Last modified on August 23, 2024 at 10:01 am by Chris Grave