How techbots2026/stormsense works
StormSense is a West Bengal severe-weather nowcasting product: it turns live atmospheric inputs into calibrated, multi-horizon forecasts, spatial risk products and dashboard views. The principal workflow runs from the browser through the operational API and nowcast service to GFS input preparation and model inference, then serves map, point-risk and advisory information. The repository also contains a separate ERA5 data-preparation and model-training path. Several dashboard capabilities are documented in the README, but their implementation and wiring are not fully visible in the excerpts.
Main entry points: nowcast_service.py Nowcast service · main.py Operational API · app.js Dashboard views · predictor.py Predictor
Components 29
Dashboard
- Dashboard views
frontend/js/app.js
API and orchestration
- Operational API
backend/main.py - Nowcast service
src/inference/nowcast_service.py - Model API
src/api/app.py
Weather inputs
- GFS harmonizer
src/inference/gfs_live.py - Surface observations
src/inference/observation_surface.py - Radar feed
src/inference/radar_observation.py - INSAT archive
src/inference/insat_archive.py - Now evidence
src/inference/now_evidence.py
Forecast and risk
- Predictor
src/inference/predictor.py - V2 model
src/models/v2_model.py - Advanced model
src/models/advanced.py - Risk maps
src/inference/risk_map.py - Risk surfaces
src/inference/risk_surface.py - Risk thresholds
src/inference/risk_thresholds.py - Target timing
src/inference/target_time.py - Feature attribution
src/inference/xai.py - Calibrated alerts
src/training/calibration.py - Model benchmark
scripts/evaluate.py
Data and models
- Configuration
src/utils/config.py - ERA5 loader
src/data/era5_loader.py - Preprocessing
src/data/preprocess.py - Label generation
src/features/targets.py - Normalization
src/features/normalize.py - Windowing
src/data/windowing.py - V2 dataset
src/data/dataset_v2.py - V2+ dataset
src/data/dataset_v2_plus.py
Other components
- Forecaster
- NOAA GFS
Connections 36
- Forecaster → Dashboard views: views forecasts
- Dashboard views → Operational API: requests forecasts
- Operational API → Nowcast service: uses service
backend/main.py - Nowcast service → GFS harmonizer: fetches inputs
src/inference/nowcast_service.py - GFS harmonizer → NOAA GFS: fetches analyses
src/inference/gfs_live.py - Nowcast service → Predictor: runs inference
src/inference/nowcast_service.py - Predictor → V2 model: loads model
src/inference/predictor.py - Predictor → Advanced model: loads model
src/inference/predictor.py - Nowcast service → Risk maps: builds risk maps
src/inference/nowcast_service.py - Nowcast service → Risk surfaces: builds surfaces
src/inference/nowcast_service.py - Nowcast service → Risk thresholds: applies thresholds
src/inference/nowcast_service.py - Nowcast service → Target timing: resolves leads
src/inference/nowcast_service.py - Nowcast service → Feature attribution: requests attribution
src/inference/nowcast_service.py - Operational API → Surface observations: renders observations
backend/main.py - Operational API → Radar feed: serves radar feed
backend/main.py - Operational API → INSAT archive: serves satellite view
backend/main.py - Operational API → Now evidence: serves evidence
backend/main.py - Model API → Predictor: runs inference
src/api/app.py - Model API → Risk maps: serves risk map
src/api/app.py - Operational API → Normalization: normalizes features
backend/main.py - Preprocessing → ERA5 loader: loads reanalysis
src/data/preprocess.py - Preprocessing → Label generation: generates labels
src/data/preprocess.py - Preprocessing → Normalization: fits normalization
src/data/preprocess.py - V2 dataset → Windowing: builds windows
src/data/dataset_v2.py - V2+ dataset → Windowing: builds windows
src/data/dataset_v2_plus.py - V2 dataset → Normalization: normalizes inputs
src/data/dataset_v2.py - V2+ dataset → Normalization: normalizes inputs
src/data/dataset_v2_plus.py - Predictor → Normalization: normalizes inputs
src/inference/predictor.py - Risk maps → Risk thresholds: uses thresholds
src/inference/risk_map.py - Risk surfaces → Risk thresholds: uses thresholds
src/inference/risk_surface.py - Now evidence → Risk thresholds: uses thresholds
src/inference/now_evidence.py - Dashboard views → Model benchmark: shows comparison
- Dashboard views → Calibrated alerts: shows calibrated bands
- Dashboard views → Risk surfaces: shows GIS layers
- Dashboard views → Feature attribution: shows attribution
- Configuration → GFS harmonizer: configures inputs