How keshavkhandelwal13/matsya-flood-detector works
This repository provides a flood-risk dashboard backed by rainfall and river forecasts plus geospatial risk mapping. The user-facing flow is dashboard requests to Flask data endpoints, which read generated forecast/history files; a separate run action executes the model jobs, including the mapper. The mapper’s evidenced orchestration loads and clips geospatial inputs, computes threat and vulnerability, then classifies risk and produces map/report outputs. Source excerpts do not establish the detector’s internal script sequence or all frontend-to-API wiring, so those links are omitted or marked unverified.
Main entry points: run_analysis.py Mapper analysis · app.py Flask API · combine.py Risk classification · run_model.py Model runner
Components 15
Dashboard
- Flood dashboard
frontend/script.js
API and orchestration
- Flask API
backend/app.py - Model runner
backend/run_model.py
Forecast models
- Rainfall generator
backend/csv_generator/generator.py - Rainfall prediction
backend/csv_generator/combine_generator.py - Flood detector suite
backend/flood_detector - Flood probability
backend/flood_detector/predict_flood.py - Forecast and history CSVs
backend/flood_detector
Geospatial risk mapping
- Mapper analysis
backend/flood_mapper/run_analysis.py - Geospatial inputs
backend/flood_mapper/mapper/inputs.py - Threat scoring
backend/flood_mapper/mapper/threat.py - Vulnerability raster
backend/flood_mapper/mapper/vulnerability.py - Risk classification
backend/flood_mapper/mapper/combine.py
Risk products
- Risk map and report
backend/flood_mapper/output
Other components
- Dashboard user
Connections 18
- Dashboard user → Flood dashboard: views
frontend/script.js - Flood dashboard → Flask API: requests data
- Flask API → Forecast and history CSVs: reads forecast data
backend/app.py - Flask API → Rainfall generator: runs generator
backend/app.py - Flask API → Flood detector suite: runs detector
backend/app.py - Flask API → Mapper analysis: runs analysis
backend/app.py - Model runner → Rainfall generator: runs generator
backend/run_model.py - Model runner → Flood detector suite: runs suite
backend/run_model.py - Model runner → Mapper analysis: runs analysis
backend/run_model.py - Rainfall prediction → Forecast and history CSVs: writes predictions
backend/csv_generator/combine_generator.py - Flood probability → Forecast and history CSVs: writes forecast
backend/flood_detector/predict_flood.py - Mapper analysis → Geospatial inputs: loads and clips
backend/flood_mapper/run_analysis.py - Mapper analysis → Threat scoring: calculates threat
backend/flood_mapper/run_analysis.py - Mapper analysis → Vulnerability raster: calculates vulnerability
backend/flood_mapper/run_analysis.py - Mapper analysis → Risk classification: combines and classifies
backend/flood_mapper/run_analysis.py - Risk classification → Risk map and report: generates outputs
backend/flood_mapper/mapper/combine.py - Geospatial inputs → Risk classification: supplies clipped data
- Vulnerability raster → Risk classification: supplies vulnerability