# amov-lab/prometheus architecture

> Architecture diagram of the GitHub repository amov-lab/prometheus, 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/amov-lab/prometheus
- Repository: https://github.com/amov-lab/prometheus

## Overview

Prometheus is a ROS/PX4 companion-computer platform for autonomous UAV development, with related UGV control, planning, perception, communications, and simulation modules. The principal operational path is a command entering the UAV controller, which publishes setpoints to the flight stack; its controller choices and parameter support are visible in the sampled headers. The README documents planning and detection as major capabilities, but their runtime wiring is not shown in the excerpts, so those branches are represented without asserted call sequences. The repository tree and README support subsystem coverage; unsampled links remain unverified.

Main entry points: [`Modules/uav_control/src/uav_controller.cpp`](https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/src/uav_controller.cpp) (UAV controller), [`Modules/uav_control/include/Position_Controller/pos_controller_PID.h`](https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/include/Position_Controller/pos_controller_PID.h) (Position controllers), [`Modules/uav_control/include/Position_Controller/controller_utils.h`](https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/include/Position_Controller/controller_utils.h) (Controller utilities), [`Modules/ugv_control/src/ugv_controller.cpp`](https://github.com/amov-lab/prometheus/blob/main/Modules/ugv_control/src/ugv_controller.cpp) (UGV controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flight["Vehicle control"]
  node_uav_controller["UAV controller<br/>[uav_controller.cpp]"]
  node_position_control["Position controllers"]
  node_uav_helpers["Controller utilities<br/>[controller_utils.h]"]
  node_ugv_controller["UGV controller<br/>[ugv_controller.cpp]"]
end

subgraph group_planning["Motion planning"]
  node_global_planner["Global planning<br/>[global_planner.cpp]"]
  node_local_planner["Local planning<br/>[local_planner.cpp]"]
  node_min_snap["Min-snap trajectories"]
  node_swarm_planner["Swarm replanning"]
end

subgraph group_perception["Perception"]
  node_fast_lio["LiDAR odometry<br/>[laserMapping.cpp]"]
  node_object_detection["Object detection<br/>[drone_detector.cpp]"]
  node_aircraft_detection["Ellipse detection"]
end

subgraph group_platform["Communication and simulation"]
  node_communication["ROS communication"]
  node_parameter_manager["Parameter manager<br/>[param_manager.cpp]"]
  node_airsim_physics["AirSim physics"]
end

node_operator(("Operator / ROS"))
node_px4["PX4 / MAVROS"]

node_operator -.->|"sends commands"| node_uav_controller
node_uav_controller -->|"publishes setpoints"| node_px4
node_uav_controller -->|"selects controller"| node_position_control
node_position_control -->|"uses utilities"| node_uav_helpers
node_uav_controller -->|"uses parameters"| node_parameter_manager
node_operator -.->|"sends commands"| node_ugv_controller
node_operator -.->|"requests planning"| node_global_planner
node_operator -.->|"requests planning"| node_local_planner
node_operator -.->|"requests trajectory"| node_min_snap
node_operator -.->|"requests replanning"| node_swarm_planner
node_operator -.->|"provides sensor data"| node_fast_lio
node_operator -.->|"requests detection"| node_object_detection
node_operator -.->|"requests detection"| node_aircraft_detection
node_operator -.->|"exchanges messages"| node_communication
node_operator -.->|"simulates flight"| node_airsim_physics

click node_uav_controller "https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/src/uav_controller.cpp"
click node_position_control "https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/include/Position_Controller/pos_controller_PID.h"
click node_uav_helpers "https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/include/Position_Controller/controller_utils.h"
click node_ugv_controller "https://github.com/amov-lab/prometheus/blob/main/Modules/ugv_control/src/ugv_controller.cpp"
click node_global_planner "https://github.com/amov-lab/prometheus/blob/main/Modules/motion_planning/global_planner/src/global_planner.cpp"
click node_local_planner "https://github.com/amov-lab/prometheus/blob/main/Modules/motion_planning/local_planner/src/local_planner.cpp"
click node_min_snap "https://github.com/amov-lab/prometheus/blob/main/Modules/motion_planning/min_snap_trajectory/min_snap/src/min_snap_generator.cpp"
click node_swarm_planner "https://github.com/amov-lab/prometheus/blob/main/Modules/ego_planner_swarm/plan_manage/src/planner_manager.cpp"
click node_fast_lio "https://github.com/amov-lab/prometheus/blob/main/Modules/FAST_LIO/src/laserMapping.cpp"
click node_object_detection "https://github.com/amov-lab/prometheus/blob/main/Modules/ego_planner_swarm/drone_detect/src/drone_detector.cpp"
click node_aircraft_detection "https://github.com/amov-lab/prometheus/blob/main/Modules/future_aircraft/src/ellipse_detector/ellipse_detector.cpp"
click node_communication "https://github.com/amov-lab/prometheus/blob/main/Modules/communication/src/communication_bridge.cpp"
click node_parameter_manager "https://github.com/amov-lab/prometheus/blob/main/Modules/communication/src/param_manager.cpp"
click node_airsim_physics "https://github.com/amov-lab/prometheus/blob/main/Simulator/airsim_simulator/airsim_ros/AirLib/include/physics/FastPhysicsEngine.hpp"

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_uav_controller,node_position_control,node_uav_helpers,node_ugv_controller toneBlue
class node_global_planner,node_local_planner,node_min_snap,node_swarm_planner toneAmber
class node_fast_lio,node_object_detection,node_aircraft_detection toneMint
class node_communication,node_parameter_manager,node_airsim_physics toneRose
class node_operator,node_px4 toneIndigo
```

## Components

### Vehicle control

- [UAV controller](https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/src/uav_controller.cpp): `Modules/uav_control/src/uav_controller.cpp`
- [Position controllers](https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/include/Position_Controller/pos_controller_PID.h): `Modules/uav_control/include/Position_Controller/pos_controller_PID.h`
- [Controller utilities](https://github.com/amov-lab/prometheus/blob/main/Modules/uav_control/include/Position_Controller/controller_utils.h): `Modules/uav_control/include/Position_Controller/controller_utils.h`
- [UGV controller](https://github.com/amov-lab/prometheus/blob/main/Modules/ugv_control/src/ugv_controller.cpp): `Modules/ugv_control/src/ugv_controller.cpp`

### Motion planning

- [Global planning](https://github.com/amov-lab/prometheus/blob/main/Modules/motion_planning/global_planner/src/global_planner.cpp): `Modules/motion_planning/global_planner/src/global_planner.cpp`
- [Local planning](https://github.com/amov-lab/prometheus/blob/main/Modules/motion_planning/local_planner/src/local_planner.cpp): `Modules/motion_planning/local_planner/src/local_planner.cpp`
- [Min-snap trajectories](https://github.com/amov-lab/prometheus/blob/main/Modules/motion_planning/min_snap_trajectory/min_snap/src/min_snap_generator.cpp): `Modules/motion_planning/min_snap_trajectory/min_snap/src/min_snap_generator.cpp`
- [Swarm replanning](https://github.com/amov-lab/prometheus/blob/main/Modules/ego_planner_swarm/plan_manage/src/planner_manager.cpp): `Modules/ego_planner_swarm/plan_manage/src/planner_manager.cpp`

### Perception

- [LiDAR odometry](https://github.com/amov-lab/prometheus/blob/main/Modules/FAST_LIO/src/laserMapping.cpp): `Modules/FAST_LIO/src/laserMapping.cpp`
- [Object detection](https://github.com/amov-lab/prometheus/blob/main/Modules/ego_planner_swarm/drone_detect/src/drone_detector.cpp): `Modules/ego_planner_swarm/drone_detect/src/drone_detector.cpp`
- [Ellipse detection](https://github.com/amov-lab/prometheus/blob/main/Modules/future_aircraft/src/ellipse_detector/ellipse_detector.cpp): `Modules/future_aircraft/src/ellipse_detector/ellipse_detector.cpp`

### Communication and simulation

- [ROS communication](https://github.com/amov-lab/prometheus/blob/main/Modules/communication/src/communication_bridge.cpp): `Modules/communication/src/communication_bridge.cpp`
- [Parameter manager](https://github.com/amov-lab/prometheus/blob/main/Modules/communication/src/param_manager.cpp): `Modules/communication/src/param_manager.cpp`
- [AirSim physics](https://github.com/amov-lab/prometheus/blob/main/Simulator/airsim_simulator/airsim_ros/AirLib/include/physics/FastPhysicsEngine.hpp): `Simulator/airsim_simulator/airsim_ros/AirLib/include/physics/FastPhysicsEngine.hpp`

### Other components

- **Operator / ROS**
- **PX4 / MAVROS**

## Connections

- Operator / ROS → UAV controller: sends commands
- UAV controller → PX4 / MAVROS: publishes setpoints (evidence: `Modules/uav_control/src/uav_controller.cpp`)
- UAV controller → Position controllers: selects controller
- Position controllers → Controller utilities: uses utilities (evidence: `Modules/uav_control/include/Position_Controller/pos_controller_PID.h`)
- UAV controller → Parameter manager: uses parameters
- Operator / ROS → UGV controller: sends commands
- Operator / ROS → Global planning: requests planning
- Operator / ROS → Local planning: requests planning
- Operator / ROS → Min-snap trajectories: requests trajectory
- Operator / ROS → Swarm replanning: requests replanning
- Operator / ROS → LiDAR odometry: provides sensor data
- Operator / ROS → Object detection: requests detection
- Operator / ROS → Ellipse detection: requests detection
- Operator / ROS → ROS communication: exchanges messages
- Operator / ROS → AirSim physics: simulates flight
