How shivamgawade-xs/sih26080 works
Varsha turns synthetic or real monsoon data into regime-conditioned rainfall forecasts, district decision products and scientific verification. The CLI coordinates dataset creation, model fitting and bundle compilation; the bundle is then served by FastAPI to a React console with map, district, regime, method and verification views. README documents the GFS/IMD data mode, model ladder, alerts and verification capabilities. Several subsystem links are omitted because the relevant runtime calls were not excerpted; the graph shows only evidenced relationships.
Main entry points: cli.py Pipeline CLI · App.tsx Console application · api.ts API client · Console.tsx Forecast console
Components 31
Data and regimes
- Run configuration
src/varsha/config.py - Synthetic dataset
src/varsha/data/synthetic/generator.py - GFS / IMD inputs
src/varsha/data/connectors - Dataset alignment
src/varsha/data/align.py - District boundaries
src/varsha/data/boundaries.py - Circulation predictors
src/varsha/features/predictors.py - Regime classification
src/varsha/regimes/classifier.py
Forecast modeling
- Feature registry
src/varsha/features/registry.py - B0–B4 model ladder
src/varsha/models/b4_regime_gbm.py - Heavy-rain probabilities
src/varsha/models/heavy_rain.py - Probability calibration
src/varsha/models/calibration.py
Decision products
- Pipeline CLI
src/varsha/cli.py - District aggregation
src/varsha/product/districts.py - Indicative alerts
src/varsha/product/alerts.py - Forecast explanations
src/varsha/product/explain.py - Run bundle compiler
src/varsha/product/bundle.py - Forecast API
src/varsha/api/app.py
Scientific verification
- Verification metrics
src/varsha/verify/metrics.py - Scientific controls
src/varsha/verify/controls.py - Verification reports
src/varsha/verify/report/generator.py
Web console
- Console application
web/src/App.tsx - API client
web/src/lib/api.ts - Forecast console
web/src/routes/Console.tsx - Forecast map
web/src/components/MapComponent.tsx - District inspector
web/src/components/DistrictInspector.tsx - District brief
web/src/routes/DistrictBrief.tsx - Regime view
web/src/routes/Regimes.tsx - Methods view
web/src/routes/Method.tsx - Verification view
web/src/routes/Verification.tsx - Provenance panel
web/src/components/HonestyPanel.tsx
Other components
- Forecaster
Connections 33
- Forecaster → Pipeline CLI: runs pipeline
- Pipeline CLI → Run configuration: loads settings
src/varsha/cli.py - Pipeline CLI → Synthetic dataset: generates data
src/varsha/cli.py - GFS / IMD inputs → Dataset alignment: supplies forecasts
- Pipeline CLI → Regime classification: fits classifier
src/varsha/cli.py - Regime classification → Circulation predictors: uses predictors
src/varsha/regimes/classifier.py - Pipeline CLI → B0–B4 model ladder: fits models
src/varsha/cli.py - B0–B4 model ladder → Feature registry: uses features
src/varsha/models/b4_regime_gbm.py - Pipeline CLI → Heavy-rain probabilities: fits probabilities
src/varsha/cli.py - Heavy-rain probabilities → Probability calibration: uses calibration
src/varsha/models/heavy_rain.py - Pipeline CLI → Scientific controls: runs controls
src/varsha/cli.py - Scientific controls → Verification metrics: computes scores
src/varsha/verify/controls.py - Pipeline CLI → Verification metrics: computes verification
src/varsha/cli.py - Pipeline CLI → Verification reports: generates report
src/varsha/cli.py - Pipeline CLI → Run bundle compiler: compiles outputs
src/varsha/cli.py - Run bundle compiler → District aggregation: aggregates forecasts
src/varsha/product/bundle.py - District aggregation → District boundaries: uses boundaries
src/varsha/product/districts.py - District aggregation → Indicative alerts: assigns alerts
src/varsha/product/districts.py - Run bundle compiler → Forecast API: serves artifacts
- Forecaster → Console application: opens console
- Console application → API client: fetches metadata
web/src/App.tsx - Console application → Forecast console: routes to
web/src/App.tsx - Console application → District brief: routes to
web/src/App.tsx - Console application → Regime view: routes to
web/src/App.tsx - Console application → Methods view: routes to
web/src/App.tsx - Console application → Verification view: routes to
web/src/App.tsx - Forecast console → API client: requests forecasts
web/src/routes/Console.tsx - Forecast console → Forecast map: renders map
web/src/routes/Console.tsx - Forecast console → District inspector: renders inspector
web/src/routes/Console.tsx - District brief → API client: requests detail
web/src/routes/DistrictBrief.tsx - Verification view → API client: requests scores
web/src/routes/Verification.tsx - Verification view → Provenance panel: renders provenance
web/src/routes/Verification.tsx - API client → Forecast API: calls HTTP API
web/src/lib/api.ts