# swatimishra0416-png/emergencycommunicationai architecture

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

- Interactive diagram: https://gitdiagram.com/swatimishra0416-png/emergencycommunicationai
- Repository: https://github.com/swatimishra0416-png/emergencycommunicationai

## Overview

This repository is an AI-assisted emergency-network next-hop routing module. Its principal runtime path accepts nearby-node data through a backend-facing interface, filters unavailable and low-battery candidates, ranks eligible nodes using a trained classifier, and selects a next hop; multi-hop routing repeats that decision while tracking visited nodes and hop limits, and adaptive routing recalculates after condition updates. Dataset preparation, model training, and evaluation support this runtime. Source excerpts show the core calls; README claims provide context for documented capabilities, while unsampled code is not assumed to add specific wiring.

Main entry points: [`models`](https://github.com/swatimishra0416-png/emergencycommunicationai/tree/main/models) (Trained classifiers), [`battery_aware_routing.py`](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/battery_aware_routing.py) (Battery eligibility), [`multi_hop_routing.py`](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/multi_hop_routing.py) (Multi-hop route builder), [`dataset/processed_dataset.csv`](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/dataset/processed_dataset.csv) (Processed observations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Dataset preparation"]
  node_generator["Synthetic data generation"]
  node_rawdata[("Routing observations")]
  node_preprocess["Data preprocessing<br/>[preprocess.py]"]
  node_processed[("Processed observations")]
end

subgraph group_models["Model lifecycle"]
  node_training["Model training<br/>[train_models.py]"]
  node_artifacts[("Trained classifiers")]
  node_evaluation["Model evaluation<br/>[evaluate_models.py]"]
end

subgraph group_decision["Next-hop decision"]
  node_prediction_demo["Standalone prediction<br/>[predict_route.py]"]
  node_interface["Routing interface<br/>[ai_interface.py]"]
  node_battery["Battery eligibility"]
  node_predictor["AI ranking<br/>[routing_ai.py]"]
end

subgraph group_routes["Route construction"]
  node_multihop["Multi-hop route builder"]
end

subgraph group_adaptive["Adaptive routing"]
  node_adaptive["Condition updates"]
end

node_network(("Emergency network caller"))

node_generator -->|"writes samples"| node_rawdata
node_preprocess -->|"reads data"| node_rawdata
node_preprocess -->|"writes processed data"| node_processed
node_training -->|"reads data"| node_processed
node_training -->|"saves classifiers"| node_artifacts
node_evaluation -->|"loads classifiers"| node_artifacts
node_evaluation -->|"evaluates on data"| node_processed
node_network -.->|"submits candidates"| node_interface
node_interface -->|"delegates decision"| node_battery
node_battery -->|"ranks eligible nodes"| node_predictor
node_predictor -->|"loads classifier"| node_artifacts
node_prediction_demo -->|"loads classifier"| node_artifacts
node_network -.->|"requests route"| node_multihop
node_multihop -->|"selects each hop"| node_battery
node_adaptive -->|"recalculates route"| node_multihop

click node_generator "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/generate_dataset.py"
click node_rawdata "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/dataset/routing_dataset.csv"
click node_preprocess "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/preprocess.py"
click node_processed "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/dataset/processed_dataset.csv"
click node_training "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/train_models.py"
click node_artifacts "https://github.com/swatimishra0416-png/emergencycommunicationai/tree/main/models"
click node_evaluation "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/evaluate_models.py"
click node_prediction_demo "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/predict_route.py"
click node_interface "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/ai_interface.py"
click node_battery "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/battery_aware_routing.py"
click node_predictor "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/routing_ai.py"
click node_multihop "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/multi_hop_routing.py"
click node_adaptive "https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/adaptive_routing.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_generator,node_rawdata,node_preprocess,node_processed toneBlue
class node_training,node_artifacts,node_evaluation toneAmber
class node_prediction_demo,node_interface,node_battery,node_predictor toneMint
class node_multihop toneRose
class node_adaptive,node_network toneIndigo
```

## Components

### Dataset preparation

- [Synthetic data generation](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/generate_dataset.py): `generate_dataset.py`
- [Routing observations](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/dataset/routing_dataset.csv): `dataset/routing_dataset.csv`
- [Data preprocessing](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/preprocess.py): `preprocess.py`
- [Processed observations](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/dataset/processed_dataset.csv): `dataset/processed_dataset.csv`

### Model lifecycle

- [Model training](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/train_models.py): `train_models.py`
- [Trained classifiers](https://github.com/swatimishra0416-png/emergencycommunicationai/tree/main/models): `models`
- [Model evaluation](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/evaluate_models.py): `evaluate_models.py`

### Next-hop decision

- [Standalone prediction](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/predict_route.py): `predict_route.py`
- [Routing interface](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/ai_interface.py): `ai_interface.py`
- [Battery eligibility](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/battery_aware_routing.py): `battery_aware_routing.py`
- [AI ranking](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/routing_ai.py): `routing_ai.py`

### Route construction

- [Multi-hop route builder](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/multi_hop_routing.py): `multi_hop_routing.py`

### Adaptive routing

- [Condition updates](https://github.com/swatimishra0416-png/emergencycommunicationai/blob/main/adaptive_routing.py): `adaptive_routing.py`

### Other components

- **Emergency network caller**

## Connections

- Synthetic data generation → Routing observations: writes samples (evidence: `generate_dataset.py`)
- Data preprocessing → Routing observations: reads data (evidence: `preprocess.py`)
- Data preprocessing → Processed observations: writes processed data (evidence: `preprocess.py`)
- Model training → Processed observations: reads data (evidence: `train_models.py`)
- Model training → Trained classifiers: saves classifiers (evidence: `train_models.py`)
- Model evaluation → Trained classifiers: loads classifiers (evidence: `evaluate_models.py`)
- Model evaluation → Processed observations: evaluates on data (evidence: `evaluate_models.py`)
- Emergency network caller → Routing interface: submits candidates (evidence: `README.md`)
- Routing interface → Battery eligibility: delegates decision (evidence: `ai_interface.py`)
- Battery eligibility → AI ranking: ranks eligible nodes (evidence: `battery_aware_routing.py`)
- AI ranking → Trained classifiers: loads classifier (evidence: `routing_ai.py`)
- Standalone prediction → Trained classifiers: loads classifier (evidence: `predict_route.py`)
- Emergency network caller → Multi-hop route builder: requests route (evidence: `README.md`)
- Multi-hop route builder → Battery eligibility: selects each hop (evidence: `multi_hop_routing.py`)
- Condition updates → Multi-hop route builder: recalculates route (evidence: `adaptive_routing.py`)
