# aaryamallik03/flood_damage_assessment architecture

> Architecture diagram of the GitHub repository aaryamallik03/flood_damage_assessment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aaryamallik03/flood_damage_assessment
- Repository: https://github.com/aaryamallik03/flood_damage_assessment

## Overview

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: [`src/train/train_damage_classifier.py`](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/train/train_damage_classifier.py) (Damage training), [`src/train/train_segmentation.py`](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/train/train_segmentation.py) (Segmentation training), [`backend/main.py`](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/backend/main.py) (Assessment API), [`src/inference/predict.py`](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/inference/predict.py) (Damage predictor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_damage["Building Damage"]
  node_damage_train["Damage training"]
  node_damage_data["Building patch dataset<br/>[preprocessing.py]"]
  node_damage_model["Siamese classifier"]
  node_metrics["Evaluation metrics<br/>[metrics.py]"]
end

subgraph group_flood["Flood Mapping"]
  node_flood_train["Segmentation training"]
  node_sar_data["SAR mask dataset<br/>[preprocessing.py]"]
  node_flood_model["Flood segmenter"]
end

subgraph group_data["Data &amp; Validation"]
  node_xbd_source(("xBD imagery source"))
  node_xbd_download["xBD downloader<br/>[download_xbd.py]"]
  node_sentinel_source(("Sentinel imagery source"))
  node_sentinel_download["Sentinel downloader"]
  node_ndrrma(("NDRRMA reports"))
  node_sitrep["Situation-report parser<br/>[ndrrma_sitrep.py]"]
  node_bipad(("BIPAD portal"))
  node_bipad_client["BIPAD client<br/>[bipad_client.py]"]
end

subgraph group_serving["Inference Service"]
  node_api["Assessment API<br/>[main.py]"]
  node_config["Model settings<br/>[config.yaml]"]
  node_damage_infer["Damage predictor<br/>[predict.py]"]
  node_flood_infer["Flood predictor<br/>[predict.py]"]
end

node_analyst(("Assessment user"))

node_analyst -->|"submits imagery"| node_api
node_api -->|"loads settings"| node_config
node_api -->|"calls predictor"| node_damage_infer
node_damage_infer -->|"runs model"| node_damage_model
node_flood_infer -->|"runs model"| node_flood_model
node_damage_train -->|"loads samples"| node_damage_data
node_damage_train -->|"trains model"| node_damage_model
node_damage_train -->|"computes scores"| node_metrics
node_flood_train -->|"loads samples"| node_sar_data
node_flood_train -->|"trains model"| node_flood_model
node_flood_train -->|"computes IoU"| node_metrics
node_xbd_source -.->|"provides imagery"| node_xbd_download
node_sentinel_source -.->|"provides imagery"| node_sentinel_download
node_ndrrma -->|"publishes reports"| node_sitrep
node_bipad -.->|"serves records"| node_bipad_client

click node_api "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/backend/main.py"
click node_config "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/configs/config.yaml"
click node_damage_infer "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/inference/predict.py"
click node_flood_infer "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/inference/predict.py"
click node_damage_train "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/train/train_damage_classifier.py"
click node_damage_data "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/preprocessing.py"
click node_damage_model "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/models/damage_classifier.py"
click node_flood_train "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/train/train_segmentation.py"
click node_sar_data "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/preprocessing.py"
click node_flood_model "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/models/flood_segmentation.py"
click node_metrics "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/utils/metrics.py"
click node_xbd_download "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/download_xbd.py"
click node_sentinel_download "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/download_sentinel.py"
click node_sitrep "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/ndrrma_sitrep.py"
click node_bipad_client "https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/bipad_client.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_damage_train,node_damage_data,node_damage_model,node_metrics,node_analyst toneBlue
class node_flood_train,node_sar_data,node_flood_model toneAmber
class node_xbd_source,node_xbd_download,node_sentinel_source,node_sentinel_download,node_ndrrma,node_sitrep,node_bipad,node_bipad_client toneMint
class node_api,node_config,node_damage_infer,node_flood_infer toneRose
```

## Components

### Building Damage

- [Damage training](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/train/train_damage_classifier.py): `src/train/train_damage_classifier.py`
- [Building patch dataset](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/preprocessing.py): `src/data/preprocessing.py`
- [Siamese classifier](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/models/damage_classifier.py): `src/models/damage_classifier.py`
- [Evaluation metrics](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/utils/metrics.py): `src/utils/metrics.py`

### Flood Mapping

- [Segmentation training](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/train/train_segmentation.py): `src/train/train_segmentation.py`
- [SAR mask dataset](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/preprocessing.py): `src/data/preprocessing.py`
- [Flood segmenter](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/models/flood_segmentation.py): `src/models/flood_segmentation.py`

### Data & Validation

- **xBD imagery source**
- [xBD downloader](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/download_xbd.py): `src/data/download_xbd.py`
- **Sentinel imagery source**
- [Sentinel downloader](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/download_sentinel.py): `src/data/download_sentinel.py`
- **NDRRMA reports**
- [Situation-report parser](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/ndrrma_sitrep.py): `src/data/ndrrma_sitrep.py`
- **BIPAD portal**
- [BIPAD client](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/data/bipad_client.py): `src/data/bipad_client.py`

### Inference Service

- [Assessment API](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/backend/main.py): `backend/main.py`
- [Model settings](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/configs/config.yaml): `configs/config.yaml`
- [Damage predictor](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/inference/predict.py): `src/inference/predict.py`
- [Flood predictor](https://github.com/aaryamallik03/flood_damage_assessment/blob/main/src/inference/predict.py): `src/inference/predict.py`

### Other components

- **Assessment user**

## Connections

- Assessment user → Assessment API: submits imagery (evidence: `README.md`)
- Assessment API → Model settings: loads settings (evidence: `backend/main.py`)
- Assessment API → Damage predictor: calls predictor (evidence: `backend/main.py`)
- Damage predictor → Siamese classifier: runs model (evidence: `src/inference/predict.py`)
- Flood predictor → Flood segmenter: runs model (evidence: `src/inference/predict.py`)
- Damage training → Building patch dataset: loads samples (evidence: `src/train/train_damage_classifier.py`)
- Damage training → Siamese classifier: trains model (evidence: `src/train/train_damage_classifier.py`)
- Damage training → Evaluation metrics: computes scores (evidence: `src/train/train_damage_classifier.py`)
- Segmentation training → SAR mask dataset: loads samples (evidence: `src/train/train_segmentation.py`)
- Segmentation training → Flood segmenter: trains model (evidence: `src/train/train_segmentation.py`)
- Segmentation training → Evaluation metrics: computes IoU (evidence: `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 (evidence: `src/data/ndrrma_sitrep.py`)
- BIPAD portal → BIPAD client: serves records
