It's been a long way since OpenSfM was created by Pau Gargallo in 2013 and Mapillary. Since then, OpenSfM has been internally used as the pipeline that powers Mapillary's planet-scale 3D reconstruction, and has been used as the core SfM of OpenDroneMap and WebODM since 2016.
Through these many years, development had its high and lows, mainly focused on supporting Mapillary platform. While at Meta, development continued, but support has been stalled in the past few years, until it was announced as no longer in active development.
We loved this project and did not want it to die, so we rolled out sleeves and went back to work, eliminating major bottlenecks (speed), while adding new features.
This 1.0 release is aimed at supporting our two biggest users : OpenDroneMap (ODM/ODX) and WebODM/ODX, hence why there's a focus on GIS/Geo workflows.
This release is a big jump and the first major so here is the list of features :
📚 Full documentation lives in
doc/— new users should start with the quickstart, then the pipeline command reference and the configuration reference (the doc mirror of every option inopensfm/config.py).
🧰 Ready-made
config.yamlpresets tuned for common capture types ship underconfigs/—aerial,terrestrialandobject. Copy one into your dataset to start from sensible defaults; see workflow presets.
Guide: Georeferencing & GIS outputs
- GPS positions with X/Y/Z standard deviation (per image) — read from EXIF or imported with
extract_geolocation(config:bundle_use_gps,bundle_compensate_gps_bias) - GCP/Checkpoints with X/Y/Z standard deviation (per point) — see Ground control points (config:
bundle_use_gcp,gcp_horizontal_sd,gcp_vertical_sd) - Horizontal+Vertical coordinate system (EPSG codes, PROJ string) — compound EPSG (e.g.
EPSG:4979+5773) and raw+proj=…strings; see the output coordinate system - Geoids support through direct download to PROJ CDN (config:
proj_cdn_enabled,proj_grid_cache_dir) - TXT geolocation file parsing for generating geolocation input (
exif_overrides.json) from a text file —extract_geolocation --geotag-file
Reference: Pipeline commands · Configuration reference
- Features : HAHOG, AKAZE, SIFT, DSP-SIFT, SURF (and ORB) — config:
feature_type - Descriptors : super-fast online-trained (and pre-trained) binary quantized matching with GPU (CUDA) matching. Classic OpenCV FLANN matching. — config:
matcher_type(GPU_HAMMING/FLANN),binary_training_pairs - Matching : EXIF-based (GPS), image-based (BoW/VLAD) or hybrid (both) matching. — config: Pair selection (
matching_gps_distance,matching_bow_neighbors,matching_vlad_neighbors) - SfM : fast incremental and direct aerotriangulation support. —
reconstruct; config: Incremental reconstruction. - Scales to massive scenes : stochastic global bundle adjustment for very large reconstructions (config: Stochastic bundle) and split-into-submodels processing — see Large datasets
- Georeferencing : GPS and GCP referencing with adaptive datum shift compensation — config:
bundle_compensate_gps_bias,align_method; see Georeferencing - Cameras : perspective, fisheye and panorama (spherical) camera models support. Many different distortion flavors (Brown and others). Rolling-shutter correction via two-step compensation. — see Camera models and the supported projection types (config:
default_projection_type) - Rig : full rig support. Can automatically calibrate the rig geometry. — see Rig models /
create_rig(config:optimize_rig_parameters, Rigs) - JSON and GeoJSON export — plus interoperability exporters for COLMAP, OpenMVS, Bundler, VisualSFM, PMVS and PLY — see the exporters and
export_geocoords
How-to: Dense reconstruction & 2D maps · math: Dense matching notes
- GPU (OpenCL) PatchMatch —
compute_depthmaps; config: Depth estimation - GPU (OpenCL) SVO TSDF depthmap fusion —
fuse_depthmaps; config: Fusion - TSDF photometric refinement — config:
depthmap_fusion_svo_refine_enabled - Dual Contouring (Surface Nets) surface extraction for sharp and well defined point-clouds and meshes
- LAS, LAZ, PLY export for point cloud — config:
dense_pointcloud_export_las,dense_pointcloud_export_laz - PLY export for the mesh (
mesh.ply) — config:depthmap_fusion_mesh_enabled - Streaming octree (Potree-style) tiles for the web/point-cloud viewer (
point_cloud/) — config: Octree tiling
See 2D maps: DSM and orthophoto and Georeferencing & GIS outputs
- Direct, TSDF-based DSM and orthophoto rendering — config: DSM and orthophoto (
dsm_enabled, hole filling, coherence-enhancing shock filter, robust multi-view color baking) - Accurate geo-referencing to output coordinate system (projection 3rd-degree polynomial, TPS fallback) — output CRS derived automatically; see the output coordinate system and
dense_merging --georeferenced - GeoTIFF export —
dsm.tif/ortho.tif; see the output reference
- SfM quality metrics tables — reconstruction details
- Overlap map
- DSM/Ortho map
- Global GPS and GCP errors table — GPS/GCP errors details
- Detailed GCP errors table (control points vs. checkpoints)
- Localized report : metric/imperial units and en/fr/es/de/it — config:
report_unit_system,report_language - PDF export via
compute_statistics+export_report
- Viewer-based visualiser (SfM data only) — see viewer/README.md
- Web/point-cloud viewer via streaming octree tiles (
point_cloud/) — config: Octree tiling - Rerun export (SfM) with GPS/GCP data, and quality report. —
export_rerun
Guide: Benchmarking
- Reproducible per-commit benchmarks — each run builds a chosen commit in an isolated git worktree + dedicated conda env, leaving your checkout untouched
- Runs the pipeline on a configurable set of datasets, SfM-only or with the full dense stages (
--dense) - HTML A/B report comparing quality (reconstruction, reprojection, tracks, features, GPS/GCP errors) and per-step timings against a reference commit
- Crash-safe and resumable — resume an interrupted run, re-run from a given step, bootstrap early steps from a previous run, or regenerate the report only
- Performance on Macs is suboptimal : PatchMatch kernels needs proper Metal reimplementation, as the OpenCL kernels (mostly the PatchMatch ones in
src/lib/dense/opencl_kernels.h) are not optimized for Apple Silicon (M1/.../M5). - Mesh support is experimental and still very sub-optimal — the Surface Nets mesh (config:
depthmap_fusion_mesh_enabled) is off by default (opt-in) and can leave holes in empty regions - TSDF photometric refinement doesn't bring substantial improvement (config:
depthmap_fusion_svo_refine_enabled,falseby default) - The global equaliser flatten a bit much the dynamic in case of highlights
- Windows conda locks are out-of-date and Windows support is unknown (although it's easily fixable)
- The split-merge is the old one and not out-of-core, neither is the dense/ortho/DSM
🛸 There is more on the table :
- Proper mesh support
- Revamped split/merge for massive datasets (fully out-of-core)
- Preview mode (10-20 images/sec. target)
- Gaussian Splats !



