How ritesh14g/single-pass-3d-model-generation works
PS-17 is a drone-video photogrammetry workflow: users submit footage and optional flight telemetry, then receive georeferenced 3D and map products with coverage and quality assessments. The CLI and Stage Lab provide run entry points; src/pipeline.py orchestrates resumable stages and persists artifacts for later stages. The sampled code documents preflight, ingest, export, and viewer behavior; other stage links are included only at the pipeline level, since their orchestration details were not sampled. The README is empty, so product capabilities are inferred from the source tree and excerpts.
Main entry points: pipeline.py Pipeline runner · stage.py Map export · cli.py CLI · qa Stage quality checks
Components 19
Run entry points
- CLI
src/cli.py - Stage Lab
ui/app.py - Pipeline runner
src/pipeline.py
Input preparation
- Input preflight
src/preflight/analyzer.py - Frame and telemetry ingest
src/ingest - Frame conditioning
src/condition
Reconstruction and analysis
- 3D reconstruction
src/recon - Scene fusion and zones
src/fusion
Mapping and delivery
- Georeferencing
src/geo - Map export
src/export/stage.py - Raster products
src/export/rasters.py - Web viewer packaging
src/viewer/package.py - Viewer server
src/viewer/serve.py
Quality assessment
- Stage quality checks
src/qa
Other components
- Operator
- Video and telemetry
- Reference surface
- Run artifacts
- Browser
Connections 29
- Operator → CLI: submits run
- Operator → Stage Lab: configures run
- Video and telemetry → Input preflight: checks input
- Video and telemetry → Frame and telemetry ingest: decodes frames
- CLI → Pipeline runner: runs stages
- Stage Lab → Pipeline runner: executes stages
- Pipeline runner → Input preflight: runs check
- Input preflight → Pipeline runner: returns verdict
- Pipeline runner → Frame and telemetry ingest: runs ingest
- Pipeline runner → Frame conditioning: runs conditioning
- Pipeline runner → 3D reconstruction: runs reconstruction
- Pipeline runner → Scene fusion and zones: runs fusion
- Pipeline runner → Georeferencing: runs georeferencing
- Pipeline runner → Map export: runs export
- Pipeline runner → Stage quality checks: runs evaluation
- Frame and telemetry ingest → Run artifacts: writes frame data
- Frame conditioning → Run artifacts: writes conditioned frames
- 3D reconstruction → Run artifacts: writes model outputs
- Scene fusion and zones → Run artifacts: writes zone data
- Georeferencing → Run artifacts: writes georeference
- Map export → Run artifacts: writes map formats
- Map export → Raster products: renders raster outputs
- Map export → Georeferencing: uses map transform
- Map export → Scene fusion and zones: uses zone layers
- Web viewer packaging → Run artifacts: packages run exports
- CLI → Viewer server: starts viewer
- Viewer server → Browser: serves viewer
- Stage quality checks → Reference surface: compares surface
- Stage quality checks → Run artifacts: reads run products