How fringehush-gif/colmap works
COLMAP is a general-purpose image-based 3D reconstruction system with command-line, graphical, and Python interfaces. Its central workflow takes an image collection through feature extraction and matching into SfM reconstruction, then supports dense multi-view stereo and mesh generation. It also offers global, incremental, and hierarchical reconstruction, image retrieval, calibration, and model management. The graph combines documented product capabilities with relationships visible in the supplied source index and excerpts; unsampled subsystem wiring is left out where it cannot be verified.
Main entry points: automatic_reconstruction.cc Automatic reconstruction · global_pipeline.cc Global SfM · observation_manager.cc Observation management · incremental_pipeline.cc Incremental SfM
Components 25
User Interfaces
- Command line
src/colmap/exe/colmap.cc - Graphical interface
src/colmap/ui/main_window.cc - Python bindings
src/pycolmap/main.cc
SfM Reconstruction
- Automatic reconstruction
src/colmap/controllers/automatic_reconstruction.cc - Feature extraction
src/colmap/controllers/feature_extraction.cc - Feature matching
src/colmap/controllers/feature_matching.cc - Incremental SfM
src/colmap/controllers/incremental_pipeline.cc - Global SfM
src/colmap/controllers/global_pipeline.cc - Hierarchical SfM
src/colmap/controllers/hierarchical_pipeline.cc - SfM mapping
src/colmap/sfm/incremental_mapper.cc - Observation management
src/colmap/sfm/observation_manager.cc
Dense Reconstruction
- Multi-view stereo
src/colmap/mvs/patch_match.cc - Depth and normals
src/colmap/mvs/depth_map.cc - Meshing and fusion
src/colmap/mvs/poisson_meshing.cc - Poisson reconstruction
src/thirdparty/PoissonRecon/Reconstructors.h
Scene and Algorithms
- Feature algorithms
src/colmap/feature/extractor.cc - Image retrieval
src/colmap/retrieval/vote_and_verify.cc - Reconstruction database
src/colmap/scene/database.h - 3D reconstruction model
src/colmap/scene/reconstruction.h - Model management
src/colmap/scene/reconstruction_manager.h - Camera calibration
src/colmap/scene/camera.h - Rotation averaging
src/colmap/estimators/rotation_averaging.h - Math utilities
src/colmap/math/math.h - Hash containers
src/colmap/util/hash_containers.h
Other components
- Image collection
Connections 30
- Image collection → Command line: provides images
- Image collection → Graphical interface: provides images
- Image collection → Python bindings: provides images
- Command line → Automatic reconstruction: starts reconstruction
- Graphical interface → Automatic reconstruction: starts reconstruction
- Automatic reconstruction → Feature extraction: runs workflow
- Automatic reconstruction → Feature matching: runs workflow
- Feature extraction → Feature algorithms: uses algorithms
- Feature matching → Image retrieval: uses retrieval
- Automatic reconstruction → Incremental SfM: selects pipeline
- Automatic reconstruction → Global SfM: selects pipeline
- Automatic reconstruction → Hierarchical SfM: selects pipeline
- Incremental SfM → Reconstruction database: reads database
src/colmap/controllers/incremental_pipeline.cc - Global SfM → Reconstruction database: loads cache
src/colmap/controllers/global_pipeline.cc - Global SfM → Rotation averaging: uses averaging
src/colmap/controllers/global_pipeline.cc - Incremental SfM → SfM mapping: runs mapper
- Global SfM → SfM mapping: runs mapper
src/colmap/controllers/global_pipeline.cc - Hierarchical SfM → Reconstruction database: reads database
src/colmap/controllers/hierarchical_pipeline.cc - Hierarchical SfM → Observation management: uses manager
src/colmap/controllers/hierarchical_pipeline.cc - Observation management → 3D reconstruction model: updates model
src/colmap/sfm/observation_manager.cc - Observation management → Camera calibration: checks projection
src/colmap/sfm/observation_manager.cc - Observation management → Math utilities: uses utilities
src/colmap/sfm/observation_manager.cc - Observation management → Hash containers: uses containers
src/colmap/sfm/observation_manager.cc - Incremental SfM → Model management: manages models
- Global SfM → Model management: manages models
src/colmap/controllers/global_pipeline.cc - 3D reconstruction model → Camera calibration: stores calibration
- Python bindings → Incremental SfM: exposes pipeline
- Multi-view stereo → Depth and normals: estimates maps
- Depth and normals → Meshing and fusion: supports meshing
- Meshing and fusion → Poisson reconstruction: uses mesher