How dinesh-vishwakarma/vajra works
VAJRA is a severe-weather nowcasting and civil-defense platform. Its intended data workflow collects radar, satellite and atmospheric observations, preprocesses/grids them into training-ready data, and supports multiple forecast-model approaches with evaluation and tracking. The FastAPI service exposes radar and operational products to a multi-dashboard Next.js interface, including disaster operations, aviation, thermodynamics, replay, analytics and model explainability. The README documents broad capabilities not all backed by sampled implementation; edges below are limited to explicit imports, calls, or documented relationships.
Main entry points: main.py FastAPI gateway · api.ts API client · build_zarr_store.py Zarr training store · evaluation_framework.py Forecast evaluation
Components 29
Weather data
- IMD radar ingest
src/ingestion/download_imd.py - ERA5 ingest
src/ingestion/download_era5.py - Data quality checks
src/ingestion/quality_check.py - Radar preprocessing
src/features/radar_preprocessing.py - Satellite and NWP
src/features/satellite_nwp_pipeline.py - Master weather grid
src/features/build_master_grid.py - Forecast targets
src/features/target_definition.py - Zarr training store
src/features/build_zarr_store.py
Forecast modeling
- Forecast baselines
src/models/baselines.py - Classical ML
src/models/classical_ml.py - Spatial U-Net
src/models/spatial_dl.py - Spatiotemporal model
src/models/spatiotemporal_dl.py - Multimodal fusion
src/models/multimodal_fusion.py - Physics-informed model
src/models/physics_informed.py - Forecast evaluation
src/models/evaluation_framework.py - Training and tracking
src/models/mlops_tracking.py - ONNX export
src/api/onnx_exporter.py
API service
- FastAPI gateway
src/api/main.py
User dashboards
- Radar command center
ui/src/app/page.tsx - Disaster operations
ui/src/app/disaster-ops/page.tsx - Aviation safety
ui/src/app/aviation/page.tsx - Thermodynamics
ui/src/app/thermodynamics/page.tsx - Storm replay
ui/src/app/replay/page.tsx - Forecast analytics
ui/src/app/analytics/page.tsx - Model explainability
ui/src/app/models/page.tsx - Alert dashboard
ui/src/app/alerts/page.tsx - Dashboard settings
ui/src/app/settings/page.tsx - API client
ui/src/lib/api.ts
Other components
- Weather operators
Connections 39
- Weather operators → FastAPI gateway: requests products
README.md - FastAPI gateway → Radar command center: serves radar
README.md - FastAPI gateway → Disaster operations: serves operations
README.md - FastAPI gateway → Aviation safety: serves airport data
README.md - FastAPI gateway → Thermodynamics: serves soundings
README.md - FastAPI gateway → Storm replay: serves cases
README.md - FastAPI gateway → Forecast analytics: serves validation
README.md - FastAPI gateway → Model explainability: serves model info
README.md - FastAPI gateway → Alert dashboard: serves alert products
README.md - FastAPI gateway → Dashboard settings: serves settings
- FastAPI gateway → API client: provides API
- API client → Radar command center: fetches data
- API client → Disaster operations: fetches data
- API client → Aviation safety: fetches data
- API client → Thermodynamics: fetches data
- API client → Storm replay: fetches data
- API client → Forecast analytics: fetches data
- API client → Model explainability: fetches data
- IMD radar ingest → Data quality checks: checks observations
- ERA5 ingest → Data quality checks: checks observations
- Radar preprocessing → Master weather grid: grids radar
- Satellite and NWP → Master weather grid: adds fields
- Master weather grid → Forecast targets: defines targets
- Forecast targets → Zarr training store: stores training data
- Zarr training store → Forecast baselines: loads training data
src/models/baselines.py - Zarr training store → Spatial U-Net: loads training data
src/models/spatial_dl.py - Zarr training store → Spatiotemporal model: loads training data
src/models/spatiotemporal_dl.py - Zarr training store → Multimodal fusion: loads training data
- Zarr training store → Physics-informed model: loads training data
src/models/physics_informed.py - Zarr training store → Training and tracking: loads training data
src/models/mlops_tracking.py - Spatial U-Net → Forecast evaluation: evaluates forecasts
src/models/spatial_dl.py - Spatiotemporal model → Forecast evaluation: evaluates forecasts
src/models/spatiotemporal_dl.py - Multimodal fusion → Forecast evaluation: imports metrics
src/models/multimodal_fusion.py - Physics-informed model → Forecast evaluation: imports metrics
src/models/physics_informed.py - Forecast baselines → Forecast evaluation: evaluates forecasts
src/models/baselines.py - Training and tracking → Spatiotemporal model: reuses model classes
src/models/mlops_tracking.py - Training and tracking → Forecast evaluation: logs metrics
src/models/mlops_tracking.py - ONNX export → Spatial U-Net: exports U-Net
src/api/onnx_exporter.py - FastAPI gateway → Weather operators: returns products
src/api/main.py