How iadityachourasia/varshasetu works
VarshaSetu is a historical research prototype for regime-aware correction and verification of monsoon rainfall forecasts, presented through a read-only web app and API. Its documented scientific workflow goes from archived GEFS forecasts through forecast-time features and regime-aware correction to rainfall and district products, then verification against IMD observations. The app also exposes frozen evidence, regime analysis, heavy-rain products, and an experimental live-cycle view. Relationships among unsampled subsystems are included only where the README documents them; the live path is explicitly experimental, not an operational warning service.
Main entry points: api API routers · phase2b.py Regime-aware correction · app Science dashboard · evidence.py Evidence endpoints
Components 23
Web presentation
- Science dashboard
frontend-v2/src/app - API clients
frontend-v2/src/lib/api
Read-only API
- FastAPI service
backend/main.py - API routers
backend/app/api - Operational products
backend/app/api/operational.py - Evidence endpoints
backend/app/api/evidence.py - Science endpoints
backend/app/api/science.py - Regime endpoints
backend/app/api/regime_validation.py - Coastal regimes
backend/app/api/coastal_regime.py - Geo-aware products
backend/app/api/geoaware.py - Zone products
backend/app/api/zones.py - Heavy-rain products
backend/app/api/heavy_rain.py - Live-cycle endpoint
backend/app/api/live.py
Forecast science
- Regime-aware correction
backend/app/ml/phase2b.py - District products
backend/app/ml/district_product.py - Heavy-rain models
backend/app/ml/heavy_rain_product.py - Live inference pipeline
backend/app/live/pipeline.py
Data and verification
- NOAA GEFS archive
backend/app/data_sources/noaa_gefs.py - IMD rainfall archive
backend/app/data_sources/imd_rainfall.py - Frozen evidence
backend/app/api/evidence.py - Verification metrics
backend/app/verification/metrics.py
Other components
- Research user
- NOAA GEFS source
Connections 20
- Research user → Science dashboard: explores results
README.md - Science dashboard → API clients: requests products
README.md - FastAPI service → API routers: mounts routers
backend/main.py - API routers → Operational products: routes requests
backend/main.py - API routers → Evidence endpoints: routes requests
backend/main.py - API routers → Science endpoints: routes requests
backend/main.py - API routers → Regime endpoints: routes requests
backend/main.py - API routers → Coastal regimes: routes requests
backend/main.py - API routers → Geo-aware products: routes requests
backend/main.py - API routers → Zone products: routes requests
backend/main.py - API routers → Heavy-rain products: routes requests
backend/main.py - API routers → Live-cycle endpoint: routes requests
backend/main.py - NOAA GEFS archive → Regime-aware correction: provides forecasts
README.md - Regime-aware correction → District products: produces district grids
README.md - Regime-aware correction → Heavy-rain models: estimates extremes
README.md - IMD rainfall archive → Verification metrics: reference observations
README.md - Regime-aware correction → Verification metrics: evaluated by
README.md - Evidence endpoints → Frozen evidence: verifies and serves
backend/app/api/evidence.py - Live-cycle endpoint → Live inference pipeline: runs inference
backend/app/api/live.py - Live inference pipeline → NOAA GEFS source: fetches forecast data
backend/app/live/pipeline.py