How aaryamallik03/flood_damage_assessment works
This repository is a disaster-impact assessment prototype with two ML workflows: paired pre/post imagery for building damage classes and SAR imagery for flood masks. Training datasets and model wrappers form the core internal layer; a FastAPI service exposes damage inference, while flood inference exists in code but its API route is explicitly a stub. Data acquisition and Nepal situation-report validation are separate capabilities. Some acquisition modules are unsampled, so their runtime connections are not asserted.
Main entry points: train_damage_classifier.py Damage training · train_segmentation.py Segmentation training · main.py Assessment API · predict.py Damage predictor
Components 20
Building Damage
- Damage training
src/train/train_damage_classifier.py - Building patch dataset
src/data/preprocessing.py - Siamese classifier
src/models/damage_classifier.py - Evaluation metrics
src/utils/metrics.py
Flood Mapping
- Segmentation training
src/train/train_segmentation.py - SAR mask dataset
src/data/preprocessing.py - Flood segmenter
src/models/flood_segmentation.py
Data & Validation
- xBD imagery source
- xBD downloader
src/data/download_xbd.py - Sentinel imagery source
- Sentinel downloader
src/data/download_sentinel.py - NDRRMA reports
- Situation-report parser
src/data/ndrrma_sitrep.py - BIPAD portal
- BIPAD client
src/data/bipad_client.py
Inference Service
- Assessment API
backend/main.py - Model settings
configs/config.yaml - Damage predictor
src/inference/predict.py - Flood predictor
src/inference/predict.py
Other components
- Assessment user
Connections 15
- Assessment user → Assessment API: submits imagery
README.md - Assessment API → Model settings: loads settings
backend/main.py - Assessment API → Damage predictor: calls predictor
backend/main.py - Damage predictor → Siamese classifier: runs model
src/inference/predict.py - Flood predictor → Flood segmenter: runs model
src/inference/predict.py - Damage training → Building patch dataset: loads samples
src/train/train_damage_classifier.py - Damage training → Siamese classifier: trains model
src/train/train_damage_classifier.py - Damage training → Evaluation metrics: computes scores
src/train/train_damage_classifier.py - Segmentation training → SAR mask dataset: loads samples
src/train/train_segmentation.py - Segmentation training → Flood segmenter: trains model
src/train/train_segmentation.py - Segmentation training → Evaluation metrics: computes IoU
src/train/train_segmentation.py - xBD imagery source → xBD downloader: provides imagery
- Sentinel imagery source → Sentinel downloader: provides imagery
- NDRRMA reports → Situation-report parser: publishes reports
src/data/ndrrma_sitrep.py - BIPAD portal → BIPAD client: serves records