# eyantra-robotics-competition/eyrc-25-26_krishi_drone architecture

> Architecture diagram of the GitHub repository eyantra-robotics-competition/eyrc-25-26_krishi_drone, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone
- Repository: https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone

## Overview

##### Project type and purpose
- This is a ROS-based robotics simulation project (“eYRC25-26 Krishi Drone Theme”) that uses the Gazebo simulator to fly and control a nano-drone in a virtual greenhouse. It comprises:
- swift_pico: Control algorithms (PID/LQR) and ROS launch/scripts
- swift_pico_description: Gazebo world + SDF/XACRO models for the drone, arena, packages
- whycon: Overhead camera localization
- mav_comm / rotors_simulator / controller_tuner: Supporting middleware, simulation of vehicle dynamics, and parameter tuning

##### File structure
- Top-level modules:
- rotors_simulator: Gazebo plugin for rotor dynamics
- mav_comm: Middleware for MAVLink communication
- controller_tuner: ROS node(s) to tune PID/LQR gains at runtime
- whycon: Vision-based localization package
- swift_pico & swift_pico_description: Main application package (launch, config, src, world, models)
- Look for:
- swift_pico/launch/*.launch.py – orchestration of nodes and Gazebo world
- swift_pico/config/*.yaml – parameters for ROS nodes and map/bridge settings
- swift_pico/src/*.cpp/.py – control algorithms (PID, LQR)
- swift_pico_description/models & worlds – static simulation assets

##### README for additional insights
- Simulation phase using Gazebo before proceeding to hardware
- The drone must navigate an arena, detect infested plants via overhead vision, pick up and apply pesticides

##### Detail
- Sequence of launch executions (task_0.launch.py, task_1c.launch.py)
- Call out map_bridge.yaml and swift_pico_bridge.yaml for coordinate transforms
- Where the arena and package models live (swift_pico_description/models)
- Control flows (perception → pose_estimate → control → actuators)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Simulation Layer"
        direction TB
        Gazebo["Gazebo Simulator"]:::sim
        ArenaWorld["arena.sdf"]:::sim
        EmptyWorld["empty.sdf"]:::sim
        SwiftWorld["swift_pico.sdf"]:::sim
        ArenaModelSDF["arena/model.sdf"]:::sim
        ArenaMesh["arena/meshes/arena.dae"]:::sim
        Pkg1["package_1/model.sdf"]:::sim
        Pkg2["package_2/model.sdf"]:::sim
        Pkg3["package_3/model.sdf"]:::sim
        DroneSDF["swift_pico.sdf"]:::sim
        WhyconMarker["whycon_marker_file.xacro"]:::sim
        rotors["rotors_simulator\n(physics plugin)"]:::sim
    end

    ROSMaster["ROS Master"]:::ros

    subgraph "Perception Layer"
        direction TB
        WhyconNode["whycon Node\n(camera & detection)"]:::per
    end

    subgraph "Control Layer"
        direction TB
        PIDCPP["pico_controller_PID.cpp"]:::ctl
        PIDPy["pico_controller_PID.py"]:::ctl
        LQRCPP["pico_controller_LQR.cpp"]:::ctl
        LQRPy["pico_controller_LQR.py"]:::ctl
        TunerNode["controller_tuner\n(parameter tuning)"]:::ctl
        Task1aCPP["task1a.cpp"]:::ctl
        Task1aPy["task1a.py"]:::ctl
    end

    subgraph "Communication Layer"
        direction TB
        MAVComm["mav_comm\n(MAVLink middleware)"]:::com
    end

    subgraph "Configuration"
        direction TB
        Config1["map_bridge.yaml"]:::param
        Config2["swift_pico_bridge.yaml"]:::param
        ParamServer["Parameter Server"]:::param
    end

    subgraph "Launch Orchestration"
        direction TB
        Launch0["task_0.launch.py"]:::launch
        Launch1["task_1c.launch.py"]:::launch
    end

    %% Connections
    Gazebo -->|"camera_image"| WhyconNode
    WhyconNode -->|"/whycon/pose"| PIDCPP
    WhyconNode -->|"/whycon/pose"| LQRCPP
    PIDCPP -->|"/cmd_vel"| MAVComm
    LQRCPP -->|"/cmd_vel"| MAVComm
    MAVComm -->|"MAVLink cmd"| rotors
    TunerNode -->|"/rosparam get/set"| ParamServer
    Config1 --> ParamServer
    Config2 --> ParamServer
    Launch0 --> Gazebo
    Launch0 --> WhyconNode
    Launch0 --> PIDCPP
    Launch0 --> LQRCPP
    Launch1 --> TunerNode
    ROSMaster --- WhyconNode
    ROSMaster --- PIDCPP
    ROSMaster --- LQRCPP
    ROSMaster --- TunerNode
    ROSMaster --- MAVComm

    %% Click Events
    click ArenaWorld "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/worlds/arena.sdf"
    click EmptyWorld "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/worlds/empty.sdf"
    click SwiftWorld "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/worlds/swift_pico.sdf"
    click ArenaModelSDF "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/arena/model.sdf"
    click ArenaMesh "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/arena/meshes/arena.dae"
    click Pkg1 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/package_1/model.sdf"
    click Pkg2 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/package_2/model.sdf"
    click Pkg3 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/package_3/model.sdf"
    click DroneSDF "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/swift_pico/swift_pico.sdf"
    click WhyconMarker "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/models/swift_pico/whycon_marker_file.xacro"
    click rotors "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/tree/kd_sim/rotors_simulator/"
    click MAVComm "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/tree/kd_sim/mav_comm/"
    click TunerNode "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/tree/kd_sim/controller_tuner/"
    click WhyconNode "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/tree/kd_sim/whycon/"
    click PIDCPP "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/src/pico_controller_PID.cpp"
    click PIDPy "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/src/pico_controller_PID.py"
    click LQRCPP "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/src/pico_controller_LQR.cpp"
    click LQRPy "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/src/pico_controller_LQR.py"
    click Task1aCPP "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/scripts/task1a.cpp"
    click Task1aPy "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/scripts/task1a.py"
    click Launch0 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/launch/task_0.launch.py"
    click Launch1 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/launch/task_1c.launch.py"
    click Config1 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/config/map_bridge.yaml"
    click Config2 "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/config/swift_pico_bridge.yaml"
    click CMakeSwift "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/CMakeLists.txt"
    click PKGXMLSwift "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico/package.xml"
    click CMakeDesc "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/CMakeLists.txt"
    click PKGXMLDesc "https://github.com/eyantra-robotics-competition/eyrc-25-26_krishi_drone/blob/kd_sim/swift_pico_description/package.xml"

    %% Styles
    classDef sim fill:#f96,stroke:#333;
    classDef per fill:#6cf,stroke:#333;
    classDef ctl fill:#6c6,stroke:#333;
    classDef com fill:#ccc,stroke:#333;
    classDef ros fill:#fff,stroke:#333,stroke-dasharray: 5 5;
    classDef param fill:#eee,stroke:#333,stroke-dasharray: 2 2;
    classDef launch fill:#ddf,stroke:#333;
    class ArenaWorld,EmptyWorld,SwiftWorld,ArenaModelSDF,ArenaMesh,Pkg1,Pkg2,Pkg3,DroneSDF,WhyconMarker,rotors sim
    class WhyconNode per
    class PIDCPP,PIDPy,LQRCPP,LQRPy,TunerNode,Task1aCPP,Task1aPy ctl
    class MAVComm com
    class ROSMaster ros
    class Config1,Config2,ParamServer param
    class Launch0,Launch1 launch
```
