# yashwanth-69/ieee-sar-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/yashwanth-69/ieee-sar-2026
- Repository: https://github.com/yashwanth-69/ieee-sar-2026

## Overview

This is a two-part search-and-rescue submission: a flyover vision pipeline creates victim and map estimates, then a Webots controller uses those estimates to dispatch two ground robots, locate victims, and report finds. The graph preserves the documented mapping, localisation, planning, safety, coordination, and optional evaluation capabilities. Pipeline stages and several controller subsystems are documented, but their internal call wiring is not fully shown; edges therefore cite the README where it establishes the relationship.

Main entry points: [`proposed_solution.py`](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py) (Webots controller), [`src/sar_pipeline.py`](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py) (Flyover pipeline), [`src/evaluate_estimates.py`](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/evaluate_estimates.py) (Estimate evaluator), [`sim_logs/victim_location_estimates.csv`](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/sim_logs/victim_location_estimates.csv) (Victim estimates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flyover["Flyover extraction"]
  node_pipeline["Flyover pipeline<br/>[sar_pipeline.py]"]
  node_odometry["Visual odometry<br/>[sar_pipeline.py]"]
  node_wallmap["Wall mapping<br/>[sar_pipeline.py]"]
  node_victimloc["Victim localisation<br/>[sar_pipeline.py]"]
  node_visionmodels["Vision models"]
end

subgraph group_deliverables["Mission data"]
  node_victimcsv["Victim estimates"]
  node_wallcsv["Wall estimates<br/>[wall_estimates.csv]"]
  node_mapimage["Map image"]
end

subgraph group_controller["Ground control"]
  node_controllerentry["Webots controller"]
  node_robotodom["Robot odometry"]
  node_allocation["Task allocation"]
  node_globalplan["Global planning"]
  node_localplan["Local planning"]
  node_safety["Collision safety"]
  node_coordination["Robot coordination"]
  node_confirmation["Victim confirmation"]
  node_report["Find report"]
end

subgraph group_evaluation["Estimate evaluation"]
  node_evaluator["Estimate evaluator"]
end

node_footage(("UAV footage"))
node_imu(("IMU telemetry"))
node_robot(("Two ROSbots"))
node_webots(("Webots simulator"))
node_groundtruth["World ground truth"]

node_footage -->|"processes"| node_pipeline
node_imu -->|"informs"| node_odometry
node_pipeline -->|"runs"| node_odometry
node_pipeline -->|"runs"| node_wallmap
node_pipeline -->|"runs"| node_victimloc
node_visionmodels -->|"segments walls"| node_wallmap
node_visionmodels -->|"detects people"| node_victimloc
node_odometry -->|"stamps poses"| node_wallmap
node_odometry -->|"tracks frames"| node_victimloc
node_pipeline -->|"writes"| node_victimcsv
node_pipeline -->|"writes"| node_wallcsv
node_pipeline -->|"writes"| node_mapimage
node_robot -->|"runs"| node_controllerentry
node_webots -->|"launches"| node_controllerentry
node_controllerentry -->|"reads"| node_victimcsv
node_controllerentry -->|"reads"| node_wallcsv
node_controllerentry -->|"uses"| node_robotodom
node_controllerentry -->|"allocates tasks"| node_allocation
node_controllerentry -->|"plans routes"| node_globalplan
node_controllerentry -->|"selects motion"| node_localplan
node_controllerentry -->|"monitors hazards"| node_safety
node_controllerentry -->|"coordinates"| node_coordination
node_controllerentry -->|"confirms victims"| node_confirmation
node_controllerentry -->|"reports finds"| node_report
node_evaluator -->|"scores estimates"| node_victimcsv
node_evaluator -->|"parses victims"| node_groundtruth
node_evaluator -->|"imports paths"| node_pipeline

click node_pipeline "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py"
click node_odometry "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py"
click node_wallmap "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py"
click node_victimloc "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py"
click node_visionmodels "https://github.com/yashwanth-69/ieee-sar-2026/tree/main/src"
click node_victimcsv "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/sim_logs/victim_location_estimates.csv"
click node_wallcsv "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/sim_logs/wall_estimates.csv"
click node_mapimage "https://github.com/yashwanth-69/ieee-sar-2026/tree/main/sim_logs"
click node_controllerentry "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_robotodom "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_allocation "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_globalplan "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_localplan "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_safety "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_coordination "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_confirmation "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_report "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py"
click node_evaluator "https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/evaluate_estimates.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_pipeline,node_odometry,node_wallmap,node_victimloc,node_visionmodels toneBlue
class node_victimcsv,node_wallcsv,node_mapimage toneAmber
class node_controllerentry,node_robotodom,node_allocation,node_globalplan,node_localplan,node_safety,node_coordination,node_confirmation,node_report toneMint
class node_evaluator toneRose
class node_footage,node_imu,node_robot,node_webots,node_groundtruth toneIndigo
```

## Components

### Flyover extraction

- [Flyover pipeline](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py): `src/sar_pipeline.py`
- [Visual odometry](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py): `src/sar_pipeline.py`
- [Wall mapping](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py): `src/sar_pipeline.py`
- [Victim localisation](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/sar_pipeline.py): `src/sar_pipeline.py`
- [Vision models](https://github.com/yashwanth-69/ieee-sar-2026/tree/main/src): `src`

### Mission data

- [Victim estimates](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/sim_logs/victim_location_estimates.csv): `sim_logs/victim_location_estimates.csv`
- [Wall estimates](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/sim_logs/wall_estimates.csv): `sim_logs/wall_estimates.csv`
- [Map image](https://github.com/yashwanth-69/ieee-sar-2026/tree/main/sim_logs): `sim_logs`

### Ground control

- [Webots controller](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Robot odometry](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Task allocation](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Global planning](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Local planning](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Collision safety](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Robot coordination](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Victim confirmation](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`
- [Find report](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/proposed_solution.py): `proposed_solution.py`

### Estimate evaluation

- [Estimate evaluator](https://github.com/yashwanth-69/ieee-sar-2026/blob/main/src/evaluate_estimates.py): `src/evaluate_estimates.py`

### Other components

- **UAV footage**
- **IMU telemetry**
- **Two ROSbots**
- **Webots simulator**
- **World ground truth**

## Connections

- UAV footage → Flyover pipeline: processes (evidence: `readme.md`)
- IMU telemetry → Visual odometry: informs (evidence: `readme.md`)
- Flyover pipeline → Visual odometry: runs (evidence: `readme.md`)
- Flyover pipeline → Wall mapping: runs (evidence: `src/sar_pipeline.py`)
- Flyover pipeline → Victim localisation: runs (evidence: `src/sar_pipeline.py`)
- Vision models → Wall mapping: segments walls (evidence: `readme.md`)
- Vision models → Victim localisation: detects people (evidence: `readme.md`)
- Visual odometry → Wall mapping: stamps poses (evidence: `readme.md`)
- Visual odometry → Victim localisation: tracks frames (evidence: `readme.md`)
- Flyover pipeline → Victim estimates: writes (evidence: `readme.md`)
- Flyover pipeline → Wall estimates: writes (evidence: `readme.md`)
- Flyover pipeline → Map image: writes (evidence: `readme.md`)
- Two ROSbots → Webots controller: runs (evidence: `proposed_solution.py`)
- Webots simulator → Webots controller: launches (evidence: `proposed_solution.py`)
- Webots controller → Victim estimates: reads (evidence: `readme.md`)
- Webots controller → Wall estimates: reads (evidence: `readme.md`)
- Webots controller → Robot odometry: uses (evidence: `readme.md`)
- Webots controller → Task allocation: allocates tasks (evidence: `readme.md`)
- Webots controller → Global planning: plans routes (evidence: `readme.md`)
- Webots controller → Local planning: selects motion (evidence: `readme.md`)
- Webots controller → Collision safety: monitors hazards (evidence: `readme.md`)
- Webots controller → Robot coordination: coordinates (evidence: `proposed_solution.py`)
- Webots controller → Victim confirmation: confirms victims (evidence: `readme.md`)
- Webots controller → Find report: reports finds (evidence: `proposed_solution.py`)
- Estimate evaluator → Victim estimates: scores estimates (evidence: `src/evaluate_estimates.py`)
- Estimate evaluator → World ground truth: parses victims (evidence: `src/evaluate_estimates.py`)
- Estimate evaluator → Flyover pipeline: imports paths (evidence: `src/evaluate_estimates.py`)
