Skip to content

Latest commit

 

History

History
116 lines (81 loc) · 9.63 KB

RELEASE.md

File metadata and controls

116 lines (81 loc) · 9.63 KB

🛰️ RELEASE LOG

1.0

🧟 Why Now ?

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 :

🪄 New 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 in opensfm/config.py).

🧰 Ready-made config.yaml presets tuned for common capture types ship under configs/ — aerial, terrestrial and object. Copy one into your dataset to start from sensible defaults; see workflow presets.

🧭 Geolocation

Guide: Georeferencing & GIS outputs

🧩 SfM

SfM Reconstruction

Reference: Pipeline commands · Configuration reference

🍇 Dense

Dense Reconstruction

How-to: Dense reconstruction & 2D maps · math: Dense matching notes

🧇 Ortho/DSM

DSM and Ortho Extraction

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

🩺 Quality Report

Example Report

See Statistics & quality report and reporting JSON

🥽 Visualisation

Rerun Export

  • 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

⏱️ Benchmarking

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

🩹 Bugfixes

🫣 Known Issues

  • 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, false by 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 !