How thenameisdebojit/asterra-ai works
ASTERRA AI (DepthWizard) turns uploaded or map-selected imagery into relative height estimates, geospatially calibrated DSM products, and interactive 3D views. The main production path is job creation, raster ingestion and semantic analysis, depth inference, optional DEM/GCP calibration, enrichment, and reconstruction. The repository also documents progressive model adaptation and browser-based hazard visualization. Backend links follow the sampled pipeline and source references; README-described capabilities are retained where implementation details were not sampled.
Main entry points: pipeline.py Reconstruction pipeline · App.jsx Application shell · main.py FastAPI endpoints · jobs.py Job queue
Components 24
Web experience
- Application shell
frontend/src/App.jsx - Workflow state
frontend/src/store/useAppStore.js - 3D viewer
frontend/src/components/ViewerScreen.jsx - Hazard scene
frontend/src/components/hazards/useHazardScene.js - Hazard layers
frontend/src/three/hazardLayers.js
Job backend
- FastAPI endpoints
backend/main.py - Job queue
backend/jobs.py - Job and artifact store
backend/storage.py - Reconstruction pipeline
backend/pipeline.py
Depth and geospatial
- Imagery discovery
backend/services/imagery_service.py - Inference adapter
backend/services/inference_service.py - Tiled depth inference
asterra_tiled_inference.py - Semantic segmentation
backend/services/segmentation_service.py - Segmentation engine
backend/segmentation/engine.py - Calibration service
backend/services/calibration_service.py - DEM calibration
calibration/calibration_engine.py - Elevation references
backend/services/dem_service.py - Building enrichment
backend/services/building_service.py
Visualization and adaptation
- 3D reconstruction
backend/services/reconstruction_service.py - Terrain surface
visualization/terrain_surface.py - Mesh and GLB export
visualization/generate_3d.py - Progressive adaptation
phase1 - Satellite adaptation
phase2
Other components
- Imagery user
Connections 27
- Imagery user → Application shell: uses
frontend/src/App.jsx - Application shell → Workflow state: reads state
frontend/src/App.jsx - Application shell → 3D viewer: renders
frontend/src/App.jsx - Hazard scene → Hazard layers: uses layers
frontend/src/components/hazards/useHazardScene.js - Hazard scene → Workflow state: updates state
frontend/src/components/hazards/useHazardScene.js - Imagery user → FastAPI endpoints: uploads or requests
backend/main.py - FastAPI endpoints → Job queue: creates jobs
backend/main.py - Job queue → Job and artifact store: persists state
backend/jobs.py - Job queue → Reconstruction pipeline: runs pipeline
backend/jobs.py - FastAPI endpoints → Imagery discovery: requests map imagery
backend/main.py - Reconstruction pipeline → Job and artifact store: reads and updates
backend/pipeline.py - Reconstruction pipeline → Imagery discovery: materializes scenes
backend/pipeline.py - Reconstruction pipeline → Semantic segmentation: runs segmentation
backend/pipeline.py - Semantic segmentation → Segmentation engine: delegates inference
backend/services/segmentation_service.py - Reconstruction pipeline → Inference adapter: runs depth inference
backend/pipeline.py - Inference adapter → Tiled depth inference: loads and invokes
backend/services/inference_service.py - Reconstruction pipeline → Elevation references: gets elevation data
backend/pipeline.py - Reconstruction pipeline → Calibration service: requests calibration
backend/pipeline.py - Calibration service → DEM calibration: delegates calibration
backend/services/calibration_service.py - Reconstruction pipeline → Building enrichment: enriches buildings
backend/pipeline.py - Reconstruction pipeline → 3D reconstruction: requests reconstruction
backend/pipeline.py - 3D reconstruction → Mesh and GLB export: generates 3D output
backend/services/reconstruction_service.py - Reconstruction pipeline → Terrain surface: produces surface
backend/pipeline.py - Imagery user → Progressive adaptation: trains progressively
README.md - Progressive adaptation → Satellite adaptation: transfers stages
README.md - Tiled depth inference → DEM calibration: calibrates relative depth
README.md - DEM calibration → Terrain surface: enables metric surface
README.md