# harieyudha/disaster-mobilenetv2 architecture

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

- Interactive diagram: https://gitdiagram.com/harieyudha/disaster-mobilenetv2
- Repository: https://github.com/harieyudha/disaster-mobilenetv2

## Overview

Disaster-MobileNetV2 is a Python image-classification project using MobileNetV2 transfer learning to classify disaster images into six categories. Its main workflow prepares train/validation/test splits, trains a model, and evaluates it; separate modules support inference, dataset inspection, and Grad-CAM explanations. The available excerpts show dataset splitting, model construction, preprocessing, and evaluation details, but do not expose enough of the training orchestrator to verify all connections among those stages.

Main entry points: [`src/dataset.py`](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/dataset.py) (Dataset splitting), [`src/evaluate.py`](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/evaluate.py) (Model evaluation), [`src/config.py`](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/config.py) (Project configuration), [`src/train.py`](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/train.py) (Training workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Dataset and inputs"]
  node_settings["Project configuration<br/>[config.py]"]
  node_splitter["Dataset splitting<br/>[dataset.py]"]
  node_splits[("Processed splits")]
  node_preprocessing["Image preprocessing<br/>[preprocessing.py]"]
  node_augmentation["Training augmentation<br/>[augmentation.py]"]
end

subgraph group_ml["Model lifecycle"]
  node_trainer["Training workflow<br/>[train.py]"]
  node_model["MobileNetV2 classifier<br/>[model.py]"]
  node_model_store[("Saved models")]
  node_evaluator["Model evaluation<br/>[evaluate.py]"]
end

subgraph group_outputs["Inference and analysis"]
  node_predictor["Image prediction<br/>[predict.py]"]
  node_gradcam["Grad-CAM explanation<br/>[gradcam.py]"]
  node_visualization["Dataset visualization<br/>[visualization.py]"]
  node_utilities["Shared utilities<br/>[utils.py]"]
end

node_engineer(("Project user"))
node_raw[("Source images")]

node_engineer -->|"prepares data"| node_splitter
node_raw -->|"scans images"| node_splitter
node_splitter -->|"copies splits"| node_splits
node_settings -->|"configures paths"| node_splitter
node_settings -->|"sets parameters"| node_model
node_settings -->|"sets image size"| node_preprocessing
node_engineer -.->|"trains model"| node_trainer
node_trainer -->|"saves model"| node_model_store
node_engineer -->|"evaluates model"| node_evaluator
node_evaluator -->|"loads test split"| node_splits
node_engineer -->|"requests prediction"| node_predictor
node_predictor -->|"imports preprocessing"| node_preprocessing
node_predictor -->|"loads model"| node_model_store
node_engineer -->|"requests explanation"| node_gradcam
node_gradcam -->|"loads model"| node_evaluator
node_gradcam -->|"imports preprocessing"| node_preprocessing
node_engineer -->|"inspects dataset"| node_visualization
node_visualization -->|"uses distribution helper"| node_utilities
node_splitter -->|"uses shared helpers"| node_utilities
node_evaluator -->|"uses shared helpers"| node_utilities
node_trainer -.->|"uses augmentation"| node_augmentation

click node_settings "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/config.py"
click node_splitter "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/dataset.py"
click node_splits "https://github.com/harieyudha/disaster-mobilenetv2/tree/main/dataset/processed"
click node_preprocessing "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/preprocessing.py"
click node_augmentation "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/augmentation.py"
click node_trainer "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/train.py"
click node_model "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/model.py"
click node_evaluator "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/evaluate.py"
click node_predictor "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/predict.py"
click node_gradcam "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/gradcam.py"
click node_visualization "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/visualization.py"
click node_utilities "https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/utils.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_settings,node_splitter,node_splits,node_preprocessing,node_augmentation,node_engineer toneBlue
class node_trainer,node_model,node_model_store,node_evaluator,node_raw toneAmber
class node_predictor,node_gradcam,node_visualization,node_utilities toneMint
```

## Components

### Dataset and inputs

- [Project configuration](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/config.py): `src/config.py`
- [Dataset splitting](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/dataset.py): `src/dataset.py`
- [Processed splits](https://github.com/harieyudha/disaster-mobilenetv2/tree/main/dataset/processed): `dataset/processed`
- [Image preprocessing](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/preprocessing.py): `src/preprocessing.py`
- [Training augmentation](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/augmentation.py): `src/augmentation.py`

### Model lifecycle

- [Training workflow](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/train.py): `src/train.py`
- [MobileNetV2 classifier](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/model.py): `src/model.py`
- **Saved models**
- [Model evaluation](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/evaluate.py): `src/evaluate.py`

### Inference and analysis

- [Image prediction](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/predict.py): `src/predict.py`
- [Grad-CAM explanation](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/gradcam.py): `src/gradcam.py`
- [Dataset visualization](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/visualization.py): `src/visualization.py`
- [Shared utilities](https://github.com/harieyudha/disaster-mobilenetv2/blob/main/src/utils.py): `src/utils.py`

### Other components

- **Project user**
- **Source images**

## Connections

- Project user → Dataset splitting: prepares data (evidence: `src/dataset.py`)
- Source images → Dataset splitting: scans images (evidence: `src/dataset.py`)
- Dataset splitting → Processed splits: copies splits (evidence: `src/dataset.py`)
- Project configuration → Dataset splitting: configures paths (evidence: `src/dataset.py`)
- Project configuration → MobileNetV2 classifier: sets parameters (evidence: `src/model.py`)
- Project configuration → Image preprocessing: sets image size (evidence: `src/preprocessing.py`)
- Project user → Training workflow: trains model
- Training workflow → Saved models: saves model (evidence: `src/train.py`)
- Project user → Model evaluation: evaluates model (evidence: `src/evaluate.py`)
- Model evaluation → Processed splits: loads test split (evidence: `src/evaluate.py`)
- Project user → Image prediction: requests prediction (evidence: `src/predict.py`)
- Image prediction → Image preprocessing: imports preprocessing (evidence: `src/predict.py`)
- Image prediction → Saved models: loads model (evidence: `src/predict.py`)
- Project user → Grad-CAM explanation: requests explanation (evidence: `src/gradcam.py`)
- Grad-CAM explanation → Model evaluation: loads model (evidence: `src/gradcam.py`)
- Grad-CAM explanation → Image preprocessing: imports preprocessing (evidence: `src/gradcam.py`)
- Project user → Dataset visualization: inspects dataset (evidence: `src/visualization.py`)
- Dataset visualization → Shared utilities: uses distribution helper (evidence: `src/visualization.py`)
- Dataset splitting → Shared utilities: uses shared helpers (evidence: `src/dataset.py`)
- Model evaluation → Shared utilities: uses shared helpers (evidence: `src/evaluate.py`)
- Training workflow → Training augmentation: uses augmentation
