# krisikas/pickme_drone architecture

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

- Interactive diagram: https://gitdiagram.com/krisikas/pickme_drone
- Repository: https://github.com/krisikas/pickme_drone

## Overview

PickmeDrone is a ROS 2/PX4 autonomous-drone platform. A mission client issues flight and navigation requests to the offboard coordinator; it validates and tracks targets, streams control commands to PX4, and exposes flight status. Odometry bridges PX4 and ROS coordinate frames. The repository also documents RGB-D perception/SLAM, simulation, and Foxglove telemetry as major capabilities. Perception and deployment wiring is described in the README, but its implementation was not sampled, so those links are documented rather than inferred from source.

Main entry points: [`src/pickme_offboard/src/offboard_node.cpp`](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/offboard_node.cpp) (Flight coordinator), [`src/pickme_odometry/src/odometry_node.cpp`](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_odometry/src/odometry_node.cpp) (Odometry bridge), [`src/pickme_bringup/launch/core.launch.py`](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/core.launch.py) (ROS bringup), [`src/pickme_bringup/launch/perception.launch.py`](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/perception.launch.py) (RGB-D perception)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flight["Flight control"]
  node_offboard["Flight coordinator<br/>[offboard_node.cpp]"]
  node_tracker["Trajectory tracker"]
  node_safety["Safety guard<br/>[safety_guard.cpp]"]
  node_commands["PX4 commands<br/>[command_sender.cpp]"]
  node_heartbeat["Offboard heartbeat"]
end

subgraph group_frames["Frames and odometry"]
  node_odom["Odometry bridge<br/>[odometry_node.cpp]"]
end

subgraph group_perception["Perception and SLAM"]
  node_perception["RGB-D perception"]
  node_camera["Camera pipeline<br/>[camera.launch.py]"]
  node_slam["RTAB-Map SLAM"]
end

subgraph group_sim["Simulation"]
  node_sim["Gazebo and PX4 SITL<br/>[default.sdf]"]
  node_models["Vehicle models<br/>[model.sdf]"]
end

subgraph group_ops["Interfaces and telemetry"]
  node_interfaces["ROS service API<br/>[Navigate.srv]"]
  node_bringup["ROS bringup<br/>[core.launch.py]"]
  node_foxglove["Foxglove telemetry<br/>[foxglove.launch.py]"]
end

node_mission(("Mission client"))
node_px4["PX4 flight controller"]
node_gazebo["Gazebo simulator"]
node_rtab["RTAB-Map"]
node_dashboard(("Foxglove Studio"))

node_mission -->|"requests flight"| node_offboard
node_offboard -->|"serves API"| node_interfaces
node_offboard -->|"updates targets"| node_tracker
node_offboard -->|"checks safety"| node_safety
node_offboard -->|"dispatches commands"| node_commands
node_offboard -->|"manages heartbeat"| node_heartbeat
node_tracker -->|"streams setpoints"| node_px4
node_heartbeat -->|"publishes heartbeat"| node_px4
node_commands -->|"sends commands"| node_px4
node_px4 -->|"vehicle odometry"| node_odom
node_odom -->|"visual odometry"| node_px4
node_bringup -.->|"launches core"| node_offboard
node_bringup -.->|"launches odometry"| node_odom
node_camera -.->|"provides imagery"| node_perception
node_perception -.->|"runs mapping"| node_slam
node_slam -->|"feeds visual odometry"| node_odom
node_models -->|"defines vehicles"| node_gazebo
node_sim -->|"runs simulation"| node_gazebo
node_sim -->|"runs SITL"| node_px4
node_bringup -.->|"launches telemetry"| node_foxglove
node_foxglove -->|"serves telemetry"| node_dashboard
node_perception -->|"uses RGB-D SLAM"| node_rtab

click node_offboard "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/offboard_node.cpp"
click node_tracker "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/trajectory_tracker.cpp"
click node_safety "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/safety_guard.cpp"
click node_commands "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/command_sender.cpp"
click node_heartbeat "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/heartbeat_manager.cpp"
click node_odom "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_odometry/src/odometry_node.cpp"
click node_interfaces "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_interfaces/srv/Navigate.srv"
click node_bringup "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/core.launch.py"
click node_perception "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/perception.launch.py"
click node_camera "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/camera.launch.py"
click node_slam "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/perception.launch.py"
click node_sim "https://github.com/krisikas/pickme_drone/blob/main/sim/worlds/default.sdf"
click node_models "https://github.com/krisikas/pickme_drone/blob/main/sim/models/x500_depth/model.sdf"
click node_foxglove "https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/foxglove.launch.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_offboard,node_tracker,node_safety,node_commands,node_heartbeat,node_mission toneBlue
class node_odom toneAmber
class node_perception,node_camera,node_slam toneMint
class node_sim,node_models toneRose
class node_interfaces,node_bringup,node_foxglove,node_px4,node_gazebo,node_rtab,node_dashboard toneIndigo
```

## Components

### Flight control

- [Flight coordinator](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/offboard_node.cpp): `src/pickme_offboard/src/offboard_node.cpp`
- [Trajectory tracker](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/trajectory_tracker.cpp): `src/pickme_offboard/src/trajectory_tracker.cpp`
- [Safety guard](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/safety_guard.cpp): `src/pickme_offboard/src/safety_guard.cpp`
- [PX4 commands](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/command_sender.cpp): `src/pickme_offboard/src/command_sender.cpp`
- [Offboard heartbeat](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_offboard/src/heartbeat_manager.cpp): `src/pickme_offboard/src/heartbeat_manager.cpp`

### Frames and odometry

- [Odometry bridge](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_odometry/src/odometry_node.cpp): `src/pickme_odometry/src/odometry_node.cpp`

### Perception and SLAM

- [RGB-D perception](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/perception.launch.py): `src/pickme_bringup/launch/perception.launch.py`
- [Camera pipeline](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/camera.launch.py): `src/pickme_bringup/launch/camera.launch.py`
- [RTAB-Map SLAM](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/perception.launch.py): `src/pickme_bringup/launch/perception.launch.py`

### Simulation

- [Gazebo and PX4 SITL](https://github.com/krisikas/pickme_drone/blob/main/sim/worlds/default.sdf): `sim/worlds/default.sdf`
- [Vehicle models](https://github.com/krisikas/pickme_drone/blob/main/sim/models/x500_depth/model.sdf): `sim/models/x500_depth/model.sdf`

### Interfaces and telemetry

- [ROS service API](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_interfaces/srv/Navigate.srv): `src/pickme_interfaces/srv/Navigate.srv`
- [ROS bringup](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/core.launch.py): `src/pickme_bringup/launch/core.launch.py`
- [Foxglove telemetry](https://github.com/krisikas/pickme_drone/blob/main/src/pickme_bringup/launch/foxglove.launch.py): `src/pickme_bringup/launch/foxglove.launch.py`

### Other components

- **Mission client**
- **PX4 flight controller**
- **Gazebo simulator**
- **RTAB-Map**
- **Foxglove Studio**

## Connections

- Mission client → Flight coordinator: requests flight (evidence: `README.md`)
- Flight coordinator → ROS service API: serves API
- Flight coordinator → Trajectory tracker: updates targets (evidence: `src/pickme_offboard/src/offboard_node.cpp`)
- Flight coordinator → Safety guard: checks safety (evidence: `src/pickme_offboard/src/offboard_node.cpp`)
- Flight coordinator → PX4 commands: dispatches commands
- Flight coordinator → Offboard heartbeat: manages heartbeat
- Trajectory tracker → PX4 flight controller: streams setpoints (evidence: `src/pickme_offboard/src/trajectory_tracker.cpp`)
- Offboard heartbeat → PX4 flight controller: publishes heartbeat (evidence: `src/pickme_offboard/src/heartbeat_manager.cpp`)
- PX4 commands → PX4 flight controller: sends commands (evidence: `src/pickme_offboard/src/command_sender.cpp`)
- PX4 flight controller → Odometry bridge: vehicle odometry (evidence: `src/pickme_odometry/src/odometry_node.cpp`)
- Odometry bridge → PX4 flight controller: visual odometry (evidence: `src/pickme_odometry/src/odometry_node.cpp`)
- ROS bringup → Flight coordinator: launches core (evidence: `README.md`)
- ROS bringup → Odometry bridge: launches odometry (evidence: `README.md`)
- Camera pipeline → RGB-D perception: provides imagery (evidence: `README.md`)
- RGB-D perception → RTAB-Map SLAM: runs mapping (evidence: `README.md`)
- RTAB-Map SLAM → Odometry bridge: feeds visual odometry (evidence: `README.md`)
- Vehicle models → Gazebo simulator: defines vehicles (evidence: `README.md`)
- Gazebo and PX4 SITL → Gazebo simulator: runs simulation (evidence: `README.md`)
- Gazebo and PX4 SITL → PX4 flight controller: runs SITL (evidence: `README.md`)
- ROS bringup → Foxglove telemetry: launches telemetry (evidence: `README.md`)
- Foxglove telemetry → Foxglove Studio: serves telemetry (evidence: `README.md`)
- RGB-D perception → RTAB-Map: uses RGB-D SLAM (evidence: `README.md`)
