# bulnabi-snu/rac2025 architecture

> Architecture diagram of the GitHub repository bulnabi-snu/rac2025, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bulnabi-snu/rac2025
- Repository: https://github.com/bulnabi-snu/rac2025

## Overview

##### Project type and purpose
- This is a robotics/simulation full-stack application for the “Robot Aircraft Competition 2025.”
- It uses ROS2 (Humble) and PX4 SITL to simulate and control a VTOL aircraft in Gazebo, with onboard vision, gimbal control, mission planning, and custom ROS2 messages.

##### File structure
- Top-level:
- docker-related files and compose YAMLs for Intel/NVIDIA GPU setups
- assets/ and gazebo_assets/ for static images and SDF models
- src/ containing all ROS2 packages and custom scripts
- src/codes: one-off or historical/ad hoc scripts (gimbal, mission histories, USB monitoring, simple detection)
- src/custom_msgs: custom ROS2 message definitions (TargetLocation, VehicleState)
- src/vehicle_controller: ROS2 Python package for mission planning and low-level control
- src/vision_processing_nodes: ROS2 Python package for camera publishing and image-based detection

##### README for additional insights
- Environment specs (Ubuntu 22.04, ROS2 Humble, PX4 main).
- Mentions SITL and Gazebo integration (PX4_Gazebo Dockerfiles).
- Notes refactoring goals for vision/tracking code and parameter tweaks for flight.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Simulation Layer
    subgraph "Simulation Layer"
        Gazebo["Gazebo Simulation"]:::simulation
        GazeboAssets["Gazebo Simulation Assets"]:::simulation
        click GazeboAssets "https://github.com/bulnabi-snu/rac2025/tree/main/src/gazebo_assets"
        PX4Container["PX4 SITL Container"]:::simulation
        subgraph "PX4 SITL Dockerfiles"
            DockerIntel["Dockerfile.PX4_Gazebo.intel"]:::simulation
            DockerNvidia["Dockerfile.PX4_Gazebo.nvidia"]:::simulation
        end
        click DockerIntel "https://github.com/bulnabi-snu/rac2025/blob/main/dockerfiles/Dockerfile.PX4_Gazebo.intel"
        click DockerNvidia "https://github.com/bulnabi-snu/rac2025/blob/main/dockerfiles/Dockerfile.PX4_Gazebo.nvidia"
        Gazebo -->|"physics & sensors"| PX4Container
    end

    %% Middleware Layer
    subgraph "Middleware Layer"
        Bridge["ROS2↔PX4 Bridge (px4_ros_com)"]:::middleware
        click Bridge "https://github.com/bulnabi-snu/rac2025/tree/main/src/px4_ros_com"
        CustomMsgs["Custom ROS2 Message Definitions"]:::middleware
        subgraph "Custom Msgs"
            TL["TargetLocation.msg"]:::middleware
            VS["VehicleState.msg"]:::middleware
        end
        click TL "https://github.com/bulnabi-snu/rac2025/blob/main/src/custom_msgs/msg/TargetLocation.msg"
        click VS "https://github.com/bulnabi-snu/rac2025/blob/main/src/custom_msgs/msg/VehicleState.msg"
    end

    %% Control Layer
    subgraph "Control Layer"
        VCEntry["Vehicle Controller Package"]:::control
        SetupVC["setup.py"]:::control
        PackageVC["package.xml"]:::control
        click SetupVC "https://github.com/bulnabi-snu/rac2025/blob/main/src/vehicle_controller/setup.py"
        click PackageVC "https://github.com/bulnabi-snu/rac2025/blob/main/src/vehicle_controller/package.xml"
        subgraph "Core Modules"
            Bezier["bezier_handler.py"]:::control
            DroneTC["drone_target_controller.py"]:::control
            PX4Base["px4_base.py"]:::control
        end
        click Bezier "https://github.com/bulnabi-snu/rac2025/blob/main/src/vehicle_controller/vehicle_controller/core/bezier_handler.py"
        click DroneTC "https://github.com/bulnabi-snu/rac2025/blob/main/src/vehicle_controller/vehicle_controller/core/drone_target_controller.py"
        click PX4Base "https://github.com/bulnabi-snu/rac2025/blob/main/src/vehicle_controller/vehicle_controller/core/px4_base.py"
        MainMC["mc_main.py"]:::control
        click MainMC "https://github.com/bulnabi-snu/rac2025/blob/main/src/vehicle_controller/vehicle_controller/mc_main.py"
        Plans["Mission Plans (.plan files)"]:::control
        click Plans "https://github.com/bulnabi-snu/rac2025/tree/main/src/vehicle_controller/mission_plans"
    end

    %% Perception Layer
    subgraph "Perception Layer"
        VisionPkg["Vision Processing Package"]:::perception
        SetupV["setup.py"]:::perception
        PackageV["package.xml"]:::perception
        click SetupV "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/setup.py"
        click PackageV "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/package.xml"
        CamPub["camera_publisher_node.py"]:::perception
        click CamPub "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/vision_processing_nodes/camera_publisher_node.py"
        ImgProc["image_processing_node.py"]:::perception
        click ImgProc "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/vision_processing_nodes/image_processing_node.py"
        subgraph "Detection Nodes"
            Casualty["casualty.py"]:::perception
            Droptag["droptag.py"]:::perception
            Landingtag["landingtag.py"]:::perception
        end
        click Casualty "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/vision_processing_nodes/detection/casualty.py"
        click Droptag "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/vision_processing_nodes/detection/droptag.py"
        click Landingtag "https://github.com/bulnabi-snu/rac2025/blob/main/src/vision_processing_nodes/vision_processing_nodes/detection/landingtag.py"
        GimbalSubgraph["Gimbal Control Scripts"]:::perception
        Gimbal1["gimbal.py"]:::perception
        Gimbal2["gimbal_set_angle.py"]:::perception
        click Gimbal1 "https://github.com/bulnabi-snu/rac2025/blob/main/src/codes/gimbal/gimbal.py"
        click Gimbal2 "https://github.com/bulnabi-snu/rac2025/blob/main/src/codes/gimbal/gimbal_set_angle.py"
    end

    %% Utilities
    subgraph "Utilities"
        History["Ad Hoc Utility Scripts"]:::util
        click History "https://github.com/bulnabi-snu/rac2025/tree/main/src/codes/history"
        FullPlan["fullPlan.plan"]:::util
        click FullPlan "https://github.com/bulnabi-snu/rac2025/blob/main/fullPlan.plan"
        PX4Msgs["PX4 Message Definitions (MAVLink↔ROS2)"]:::middleware
        click PX4Msgs "https://github.com/bulnabi-snu/rac2025/tree/main/src/px4_msgs"
    end

    %% Connections
    PX4Container -->|"MAVLink"| Bridge
    Bridge -->|"publishes VehicleState"| VS
    VS -->|"subscribed by"| VCEntry
    TL -->|"subscribed by"| VCEntry
    CamPub -->|"publishes raw image"| ImgProc
    ImgProc -->|"publishes detections"| Casualty
    ImgProc -->|"publishes detections"| Droptag
    ImgProc -->|"publishes detections"| Landingtag
    Casualty -->|"TargetLocation"| VCEntry
    Droptag -->|"TargetLocation"| VCEntry
    Landingtag -->|"TargetLocation"| VCEntry
    VCEntry -->|"commands (MAVLink)"| PX4Container
    Plans -->|"provides waypoints"| VCEntry
    Casualty -->|"feeds"| Gimbal1
    Droptag -->|"feeds"| Gimbal2

    %% Styles
    classDef simulation fill:#D0E6FF,stroke:#357ABD,color:#000;
    classDef middleware fill:#DFFFD0,stroke:#3B9B35,color:#000;
    classDef control fill:#E6D0FF,stroke:#7B35AD,color:#000;
    classDef perception fill:#FFE6C0,stroke:#D98C00,color:#000;
    classDef util fill:#F0F0F0,stroke:#888888,color:#000
```
