How sheel34/bhuvan works
BHUVAN is a lunar terrain-intelligence platform with a Mars HiRISE analysis extension. Users explore the Moon and mission atlas, select a site, inspect reconstructed terrain and analysis layers, then generate and export reports. The browser’s React/Three.js workspace calls a FastAPI backend for terrain data and analysis; backend capabilities also include async jobs, NASA/USGS data ingestion, optional GAN enhancement, and machine telemetry. Relationships for unsampled modules are included only where the README or source index supports them.
Main entry points: main.py FastAPI service · tasks.py Analysis worker · api.js API client · App.jsx Workspace app
Components 28
Browser experience
- Workspace app
src/App.jsx - Moon globe
src/scene/MoonGlobe.jsx - Mission atlas
src/lib/lunarMissions.js - Terrain scene
src/scene/SceneCanvas.jsx - Chunked terrain
src/scene/TerrainChunked.jsx - Terrain interaction
src/engine/terrain.js - API client
src/lib/api.js - Mission dossiers
src/components/MissionDossier.jsx - Report interface
src/components/ReportModal.jsx - System monitor
src/components/SystemMonitor.jsx
Analysis backend
- FastAPI service
backend/main.py - Async job API
backend/jobs/routes.py - Analysis worker
backend/jobs/tasks.py
Terrain data
- Lunar DEM data
backend/data/dem_fetch.py - LROC downloader
backend/data/lroc_downloader.py - HiRISE downloader
backend/data/hirise_downloader.py - Tile processing
backend/data/tile_processor.py
Analysis compute
- Terrain ingestion
backend/pipeline/ingest.py - Terrain analysis
backend/pipeline/terrain_analysis.py - Surface intelligence
backend/pipeline/intelligence.py - Landing zones
backend/pipeline/landing_zones.py - TERCOM matching
backend/pipeline/tercom.py - Terrain GAN
backend/ai/runtime.py
Reports and services
- Report generation
backend/workspace/reports.py - Workspace store
backend/workspace/store.py - Machine telemetry
backend/system/telemetry.py - Celery queue
backend/jobs/celery_app.py
Other components
- Mission planner
Connections 29
- Mission planner → Moon globe: explores
README.md - Moon globe → Mission atlas: shows missions
src/scene/MoonGlobe.jsx - Mission planner → Mission dossiers: opens dossier
README.md - Workspace app → Moon globe: renders
src/App.jsx - Workspace app → Terrain scene: renders workspace
src/App.jsx - Workspace app → API client: requests terrain and reports
src/App.jsx - Terrain scene → Chunked terrain: renders terrain
src/scene/SceneCanvas.jsx - Terrain scene → Terrain interaction: samples heights
src/scene/SceneCanvas.jsx - API client → FastAPI service: calls backend
README.md - FastAPI service → Lunar DEM data: fetches DEM regions
backend/main.py - FastAPI service → LROC downloader: loads lunar data
backend/main.py - FastAPI service → Terrain analysis: runs analysis
backend/main.py - FastAPI service → Surface intelligence: requests intelligence
backend/main.py - FastAPI service → Landing zones: ranks safe zones
backend/main.py - FastAPI service → TERCOM matching: uses matching
backend/main.py - FastAPI service → Report generation: generates reports
README.md - Report interface → API client: requests report
src/App.jsx - FastAPI service → Workspace store: persists workspace
backend/main.py - System monitor → API client: requests stats
src/components/SystemMonitor.jsx - FastAPI service → Machine telemetry: reads machine stats
backend/main.py - Async job API → Celery queue: dispatches jobs
backend/jobs/routes.py - Async job API → Analysis worker: queues analysis
backend/jobs/routes.py - Analysis worker → Terrain ingestion: ingests uploads
backend/jobs/tasks.py - Analysis worker → HiRISE downloader: loads Mars DEM
backend/jobs/tasks.py - Analysis worker → FastAPI service: uses analysis pipeline
backend/jobs/tasks.py - Analysis worker → Terrain GAN: optionally enhances
backend/jobs/tasks.py - FastAPI service → HiRISE downloader: serves HiRISE catalog
backend/main.py - FastAPI service → Terrain GAN: optionally enhances terrain
README.md - HiRISE downloader → Tile processing: processes terrain tiles