How dhanvanth-dev/iit_code works
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: states Mission states · mission_manager.py Mission manager · behaviors Motion behaviors · mission_node.py Mission node
Components 16
Perception and navigation
- Gate vision
vauv_ws/src/aquavision/aquavision/vision_node.py - Navigation bridge
vauv_ws/src/aquavision/aquavision/nav_bridge_node.py
Mission control
- Mission manager
vauv_ws/src/aquavision/aquavision/mission_manager.py - Mission node
vauv_ws/src/aquavision/aquavision/mission_node.py - Mission states
vauv_ws/src/aquavision/aquavision/states - Gate search
vauv_ws/src/aquavision/aquavision/states/search_state.py - Gate alignment
vauv_ws/src/aquavision/aquavision/states/align_state.py - Gate approach
vauv_ws/src/aquavision/aquavision/states/thrust_state.py - Blind passage
vauv_ws/src/aquavision/aquavision/states/blind_pass_state.py
Control primitives
- Motion behaviors
vauv_ws/src/aquavision/aquavision/behaviors - PID controller
vauv_ws/src/aquavision/aquavision/utils/pid.py
Vehicle interface and telemetry
- Gate data
vauv_ws/src/aquavision_msgs/msg/GateData.msg - CSV telemetry
vauv_ws/src/aquavision/aquavision/utils/csv_logger.py - Vehicle commands
Other components
- Camera input
- MAVLink vehicle
Connections 17
- Camera input → Gate vision: provides frames
- Gate vision → Gate data: publishes detections
- Gate data → Mission manager: feeds perception
vauv_ws/src/aquavision/aquavision/mission_manager.py - MAVLink vehicle → Navigation bridge: provides telemetry
- Navigation bridge → Mission manager: feeds vehicle state
vauv_ws/src/aquavision/aquavision/mission_manager.py - Mission manager → Mission states: dispatches updates
vauv_ws/src/aquavision/aquavision/mission_manager.py - Mission manager → Vehicle commands: publishes controls
vauv_ws/src/aquavision/aquavision/mission_manager.py - Mission manager → CSV telemetry: writes telemetry
vauv_ws/src/aquavision/aquavision/mission_manager.py - Mission states → Gate search: exports state
vauv_ws/src/aquavision/aquavision/states/__init__.py - Mission states → Gate alignment: exports state
vauv_ws/src/aquavision/aquavision/states/__init__.py - Mission states → Gate approach: exports state
vauv_ws/src/aquavision/aquavision/states/__init__.py - Mission states → Blind passage: exports state
vauv_ws/src/aquavision/aquavision/states/__init__.py - Gate alignment → Motion behaviors: computes corrections
vauv_ws/src/aquavision/aquavision/states/align_state.py - Gate approach → Motion behaviors: computes approach
vauv_ws/src/aquavision/aquavision/states/thrust_state.py - Motion behaviors → PID controller: uses controller
vauv_ws/src/aquavision/aquavision/behaviors/vertical_control.py - Mission node → PID controller: uses controller
vauv_ws/src/aquavision/aquavision/mission_node.py - Mission node → CSV telemetry: uses logger
vauv_ws/src/aquavision/aquavision/mission_node.py