# dhanvanth-dev/iit_code architecture

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

- Interactive diagram: https://gitdiagram.com/dhanvanth-dev/iit_code
- Repository: https://github.com/dhanvanth-dev/iit_code

## Overview

Aquavision is a ROS 2 autonomous underwater vehicle gate-navigation system. Its principal workflow takes gate and vehicle-state telemetry into a mission state machine, which selects control commands for gate search, alignment, approach, passage, and completion or failsafe; commands are published to the vehicle. Vision, navigation bridging, reusable control behaviors, and telemetry logging are separate runtime concerns. The source excerpts establish mission dispatch and several state/control relationships; vision and bridge wiring is only partly verifiable from the available evidence.

Main entry points: [`vauv_ws/src/aquavision/aquavision/states`](https://github.com/dhanvanth-dev/iit_code/tree/main/vauv_ws/src/aquavision/aquavision/states) (Mission states), [`vauv_ws/src/aquavision/aquavision/mission_manager.py`](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/mission_manager.py) (Mission manager), [`vauv_ws/src/aquavision/aquavision/behaviors`](https://github.com/dhanvanth-dev/iit_code/tree/main/vauv_ws/src/aquavision/aquavision/behaviors) (Motion behaviors), [`vauv_ws/src/aquavision/aquavision/mission_node.py`](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/mission_node.py) (Mission node)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_perception["Perception and navigation"]
  node_vision["Gate vision<br/>[vision_node.py]"]
  node_nav_bridge["Navigation bridge<br/>[nav_bridge_node.py]"]
end

subgraph group_mission["Mission control"]
  node_manager["Mission manager<br/>[mission_manager.py]"]
  node_mission_node["Mission node<br/>[mission_node.py]"]
  node_states["Mission states"]
  node_search["Gate search<br/>[search_state.py]"]
  node_align["Gate alignment<br/>[align_state.py]"]
  node_thrust["Gate approach<br/>[thrust_state.py]"]
  node_blind_pass["Blind passage"]
end

subgraph group_control["Control primitives"]
  node_behaviors["Motion behaviors"]
  node_pid["PID controller<br/>[pid.py]"]
end

subgraph group_interfaces["Vehicle interface and telemetry"]
  node_gate_msg["Gate data<br/>[GateData.msg]"]
  node_logger[("CSV telemetry<br/>[csv_logger.py]")]
  node_vehicle_command["Vehicle commands"]
end

node_camera(("Camera input"))
node_mavlink["MAVLink vehicle"]

node_camera -.->|"provides frames"| node_vision
node_vision -.->|"publishes detections"| node_gate_msg
node_gate_msg -->|"feeds perception"| node_manager
node_mavlink -.->|"provides telemetry"| node_nav_bridge
node_nav_bridge -->|"feeds vehicle state"| node_manager
node_manager -->|"dispatches updates"| node_states
node_manager -->|"publishes controls"| node_vehicle_command
node_manager -->|"writes telemetry"| node_logger
node_states -->|"exports state"| node_search
node_states -->|"exports state"| node_align
node_states -->|"exports state"| node_thrust
node_states -->|"exports state"| node_blind_pass
node_align -->|"computes corrections"| node_behaviors
node_thrust -->|"computes approach"| node_behaviors
node_behaviors -->|"uses controller"| node_pid
node_mission_node -->|"uses controller"| node_pid
node_mission_node -->|"uses logger"| node_logger

click node_vision "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/vision_node.py"
click node_gate_msg "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision_msgs/msg/GateData.msg"
click node_nav_bridge "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/nav_bridge_node.py"
click node_manager "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/mission_manager.py"
click node_mission_node "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/mission_node.py"
click node_states "https://github.com/dhanvanth-dev/iit_code/tree/main/vauv_ws/src/aquavision/aquavision/states"
click node_search "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/search_state.py"
click node_align "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/align_state.py"
click node_thrust "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/thrust_state.py"
click node_blind_pass "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/blind_pass_state.py"
click node_behaviors "https://github.com/dhanvanth-dev/iit_code/tree/main/vauv_ws/src/aquavision/aquavision/behaviors"
click node_pid "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/utils/pid.py"
click node_logger "https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/utils/csv_logger.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_vision,node_nav_bridge toneBlue
class node_manager,node_mission_node,node_states,node_search,node_align,node_thrust,node_blind_pass toneAmber
class node_behaviors,node_pid toneMint
class node_gate_msg,node_logger,node_vehicle_command toneRose
class node_camera,node_mavlink toneIndigo
```

## Components

### Perception and navigation

- [Gate vision](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/vision_node.py): `vauv_ws/src/aquavision/aquavision/vision_node.py`
- [Navigation bridge](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/nav_bridge_node.py): `vauv_ws/src/aquavision/aquavision/nav_bridge_node.py`

### Mission control

- [Mission manager](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/mission_manager.py): `vauv_ws/src/aquavision/aquavision/mission_manager.py`
- [Mission node](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/mission_node.py): `vauv_ws/src/aquavision/aquavision/mission_node.py`
- [Mission states](https://github.com/dhanvanth-dev/iit_code/tree/main/vauv_ws/src/aquavision/aquavision/states): `vauv_ws/src/aquavision/aquavision/states`
- [Gate search](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/search_state.py): `vauv_ws/src/aquavision/aquavision/states/search_state.py`
- [Gate alignment](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/align_state.py): `vauv_ws/src/aquavision/aquavision/states/align_state.py`
- [Gate approach](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/thrust_state.py): `vauv_ws/src/aquavision/aquavision/states/thrust_state.py`
- [Blind passage](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/states/blind_pass_state.py): `vauv_ws/src/aquavision/aquavision/states/blind_pass_state.py`

### Control primitives

- [Motion behaviors](https://github.com/dhanvanth-dev/iit_code/tree/main/vauv_ws/src/aquavision/aquavision/behaviors): `vauv_ws/src/aquavision/aquavision/behaviors`
- [PID controller](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/utils/pid.py): `vauv_ws/src/aquavision/aquavision/utils/pid.py`

### Vehicle interface and telemetry

- [Gate data](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision_msgs/msg/GateData.msg): `vauv_ws/src/aquavision_msgs/msg/GateData.msg`
- [CSV telemetry](https://github.com/dhanvanth-dev/iit_code/blob/main/vauv_ws/src/aquavision/aquavision/utils/csv_logger.py): `vauv_ws/src/aquavision/aquavision/utils/csv_logger.py`
- **Vehicle commands**

### Other components

- **Camera input**
- **MAVLink vehicle**

## Connections

- Camera input → Gate vision: provides frames
- Gate vision → Gate data: publishes detections
- Gate data → Mission manager: feeds perception (evidence: `vauv_ws/src/aquavision/aquavision/mission_manager.py`)
- MAVLink vehicle → Navigation bridge: provides telemetry
- Navigation bridge → Mission manager: feeds vehicle state (evidence: `vauv_ws/src/aquavision/aquavision/mission_manager.py`)
- Mission manager → Mission states: dispatches updates (evidence: `vauv_ws/src/aquavision/aquavision/mission_manager.py`)
- Mission manager → Vehicle commands: publishes controls (evidence: `vauv_ws/src/aquavision/aquavision/mission_manager.py`)
- Mission manager → CSV telemetry: writes telemetry (evidence: `vauv_ws/src/aquavision/aquavision/mission_manager.py`)
- Mission states → Gate search: exports state (evidence: `vauv_ws/src/aquavision/aquavision/states/__init__.py`)
- Mission states → Gate alignment: exports state (evidence: `vauv_ws/src/aquavision/aquavision/states/__init__.py`)
- Mission states → Gate approach: exports state (evidence: `vauv_ws/src/aquavision/aquavision/states/__init__.py`)
- Mission states → Blind passage: exports state (evidence: `vauv_ws/src/aquavision/aquavision/states/__init__.py`)
- Gate alignment → Motion behaviors: computes corrections (evidence: `vauv_ws/src/aquavision/aquavision/states/align_state.py`)
- Gate approach → Motion behaviors: computes approach (evidence: `vauv_ws/src/aquavision/aquavision/states/thrust_state.py`)
- Motion behaviors → PID controller: uses controller (evidence: `vauv_ws/src/aquavision/aquavision/behaviors/vertical_control.py`)
- Mission node → PID controller: uses controller (evidence: `vauv_ws/src/aquavision/aquavision/mission_node.py`)
- Mission node → CSV telemetry: uses logger (evidence: `vauv_ws/src/aquavision/aquavision/mission_node.py`)
