# nikhilcherry/sih-antidrone architecture

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

- Interactive diagram: https://gitdiagram.com/nikhilcherry/sih-antidrone
- Repository: https://github.com/nikhilcherry/sih-antidrone

## Overview

AURA combines an environmental-degradation and pointing-compensation model with an electro-optical (EO) camera link, operator console, and live detect/engage track. The central engineering workflow models altitude and weather effects, simulates pointing with selectable compensation, and exposes those results in the console. Separately, EO frames travel from camera to laptop for detection and tracking; the intercept engine manages identification and operator-directed engagement. Edges reflect the supplied excerpts, source-index references, or README statements; unsampled subsystems and runtime details are not inferred beyond that evidence.

Main entry points: [`aura/console/model.py`](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/model.py) (Console Model), [`aura/console/server.py`](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/server.py) (Console Server), [`aura/atmosphere.py`](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/atmosphere.py) (Atmosphere Model), [`aura/intercept/server.py`](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/server.py) (Intercept Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_physics["Physics and Pointing"]
  node_atmosphere["Atmosphere Model<br/>[atmosphere.py]"]
  node_degradation["Degradation Models<br/>[degradation.py]"]
  node_pointing["Pointing Simulation<br/>[sim.py]"]
  node_scenarios["Reference Scenarios<br/>[scenarios.py]"]
end

subgraph group_eo["EO Camera Link"]
  node_sender["Frame Sender<br/>[sender.py]"]
  node_wire["Frame Protocol<br/>[protocol.py]"]
  node_receiver["Frame Receiver<br/>[receiver.py]"]
  node_mjpeg["MJPEG Service<br/>[http_stream.py]"]
  node_optics["Sensor Geometry<br/>[optics.py]"]
  node_detector["Live Detection<br/>[detect_live.py]"]
end

subgraph group_console["Operations Console"]
  node_console_ui["Console Interface<br/>[console.js]"]
  node_console_server["Console Server<br/>[server.py]"]
  node_console_model["Console Model<br/>[model.py]"]
end

subgraph group_intercept["Intercept Workflow"]
  node_engine["Intercept Engine<br/>[engine.py]"]
  node_intercept_server["Intercept Server<br/>[server.py]"]
  node_voice["Voice Interface<br/>[voice.py]"]
end

node_operator(("Operator"))
node_environment(("Site Environment"))
node_camera(("Pi Camera"))
node_browser(("Console Viewers"))
node_sdr(("RTL-SDR Device"))
node_voice_services["Speech and Language APIs"]

node_environment -->|"sets conditions"| node_atmosphere
node_atmosphere -->|"provides state"| node_degradation
node_atmosphere -->|"provides state"| node_pointing
node_degradation -->|"sets plant effects"| node_pointing
node_scenarios -->|"supplies presets"| node_console_model
node_console_model -->|"computes conditions"| node_atmosphere
node_console_model -->|"computes health"| node_degradation
node_console_model -->|"runs simulation"| node_pointing
node_camera -->|"captures frames"| node_sender
node_sender -->|"packs frames"| node_wire
node_receiver -->|"decodes frames"| node_wire
node_sender -->|"serves stream"| node_mjpeg
node_detector -->|"gates detections"| node_optics
node_receiver -->|"feeds detection"| node_detector
node_browser -->|"opens console"| node_console_ui
node_console_ui -->|"sends updates"| node_console_server
node_console_server -->|"computes results"| node_console_model
node_console_server -->|"broadcasts state"| node_browser
node_console_server -.->|"probes EO feed"| node_mjpeg
node_console_model -->|"checks presence"| node_sdr
node_detector -->|"supplies tracks"| node_engine
node_optics -->|"provides geometry"| node_engine
node_engine -->|"serves track state"| node_intercept_server
node_intercept_server -->|"orders engagement"| node_engine
node_intercept_server -->|"transcribes audio"| node_voice
node_voice -.->|"uses optional APIs"| node_voice_services
node_operator -->|"issues commands"| node_intercept_server

click node_atmosphere "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/atmosphere.py"
click node_degradation "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/degradation.py"
click node_pointing "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/sim.py"
click node_scenarios "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/scenarios.py"
click node_sender "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/sender.py"
click node_wire "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/protocol.py"
click node_receiver "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/receiver.py"
click node_mjpeg "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/http_stream.py"
click node_optics "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/optics.py"
click node_detector "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/detect_live.py"
click node_console_ui "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/static/console.js"
click node_console_server "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/server.py"
click node_console_model "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/model.py"
click node_engine "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/engine.py"
click node_intercept_server "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/server.py"
click node_voice "https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/voice.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_atmosphere,node_degradation,node_pointing,node_scenarios,node_browser toneBlue
class node_sender,node_wire,node_receiver,node_mjpeg,node_optics,node_detector toneAmber
class node_console_ui,node_console_server,node_console_model,node_voice_services toneMint
class node_engine,node_intercept_server,node_voice toneRose
class node_operator,node_environment,node_camera,node_sdr toneIndigo
```

## Components

### Physics and Pointing

- [Atmosphere Model](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/atmosphere.py): `aura/atmosphere.py`
- [Degradation Models](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/degradation.py): `aura/degradation.py`
- [Pointing Simulation](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/sim.py): `aura/sim.py`
- [Reference Scenarios](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/scenarios.py): `aura/scenarios.py`

### EO Camera Link

- [Frame Sender](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/sender.py): `aura/eo/sender.py`
- [Frame Protocol](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/protocol.py): `aura/eo/protocol.py`
- [Frame Receiver](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/receiver.py): `aura/eo/receiver.py`
- [MJPEG Service](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/http_stream.py): `aura/eo/http_stream.py`
- [Sensor Geometry](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/optics.py): `aura/eo/optics.py`
- [Live Detection](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/eo/detect_live.py): `aura/eo/detect_live.py`

### Operations Console

- [Console Interface](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/static/console.js): `aura/console/static/console.js`
- [Console Server](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/server.py): `aura/console/server.py`
- [Console Model](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/console/model.py): `aura/console/model.py`

### Intercept Workflow

- [Intercept Engine](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/engine.py): `aura/intercept/engine.py`
- [Intercept Server](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/server.py): `aura/intercept/server.py`
- [Voice Interface](https://github.com/nikhilcherry/sih-antidrone/blob/master/aura/intercept/voice.py): `aura/intercept/voice.py`

### Other components

- **Operator**
- **Site Environment**
- **Pi Camera**
- **Console Viewers**
- **RTL-SDR Device**
- **Speech and Language APIs**

## Connections

- Site Environment → Atmosphere Model: sets conditions (evidence: `README.md`)
- Atmosphere Model → Degradation Models: provides state (evidence: `aura/degradation.py`)
- Atmosphere Model → Pointing Simulation: provides state (evidence: `aura/sim.py`)
- Degradation Models → Pointing Simulation: sets plant effects (evidence: `aura/sim.py`)
- Reference Scenarios → Console Model: supplies presets (evidence: `aura/console/model.py`)
- Console Model → Atmosphere Model: computes conditions (evidence: `aura/console/model.py`)
- Console Model → Degradation Models: computes health (evidence: `aura/console/model.py`)
- Console Model → Pointing Simulation: runs simulation (evidence: `aura/console/model.py`)
- Pi Camera → Frame Sender: captures frames (evidence: `README.md`)
- Frame Sender → Frame Protocol: packs frames (evidence: `aura/eo/sender.py`)
- Frame Receiver → Frame Protocol: decodes frames (evidence: `aura/eo/receiver.py`)
- Frame Sender → MJPEG Service: serves stream (evidence: `aura/eo/sender.py`)
- Live Detection → Sensor Geometry: gates detections (evidence: `aura/eo/detect_live.py`)
- Frame Receiver → Live Detection: feeds detection (evidence: `README.md`)
- Console Viewers → Console Interface: opens console (evidence: `README.md`)
- Console Interface → Console Server: sends updates (evidence: `README.md`)
- Console Server → Console Model: computes results (evidence: `aura/console/server.py`)
- Console Server → Console Viewers: broadcasts state (evidence: `aura/console/server.py`)
- Console Server → MJPEG Service: probes EO feed (evidence: `README.md`)
- Console Model → RTL-SDR Device: checks presence (evidence: `aura/console/model.py`)
- Live Detection → Intercept Engine: supplies tracks (evidence: `aura/intercept/engine.py`)
- Sensor Geometry → Intercept Engine: provides geometry (evidence: `aura/intercept/engine.py`)
- Intercept Engine → Intercept Server: serves track state (evidence: `aura/intercept/server.py`)
- Intercept Server → Intercept Engine: orders engagement (evidence: `aura/intercept/server.py`)
- Intercept Server → Voice Interface: transcribes audio (evidence: `aura/intercept/server.py`)
- Voice Interface → Speech and Language APIs: uses optional APIs (evidence: `aura/intercept/voice.py`)
- Operator → Intercept Server: issues commands (evidence: `README.md`)
