# ebbehj/robot_competition architecture

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

## Overview

This ROS 2/Gazebo project runs a multi-robot rescue simulation. An operator starts a world-specific launch; it starts the simulator, map server, coordinator and robot navigation nodes. The coordinator processes the map into coverage viewpoints and a navigation graph, assigns regions and can dispatch a fire response. Planners compute routes and followers execute them. The repository also includes marker detection, wall-following and visualization components. Source excerpts do not show all topic wiring, so some connections are omitted rather than inferred.

Main entry points: [`launch/rescue_robots_w1.launch.py`](https://github.com/ebbehj/robot_competition/blob/main/launch/rescue_robots_w1.launch.py) (Rescue launch), [`multi_robot_challenge_23/coordinator.py`](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/coordinator.py) (Rescue coordinator), [`multi_robot_challenge_23/path_planner.py`](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/path_planner.py) (Path planner), [`multi_robot_challenge_23/graph_builder.py`](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/graph_builder.py) (Navigation graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation setup"]
  node_launch["Rescue launch"]
  node_gazebo["Gazebo world<br/>[dat160_w1.world]"]
  node_robot_models["Robot and scene models"]
  node_map_server["Map server<br/>[map_dat160_w1.yaml]"]
end

subgraph group_coordination["Mapping and coordination"]
  node_coordinator["Rescue coordinator<br/>[coordinator.py]"]
  node_coverage["Coverage analysis<br/>[coverage_map.py]"]
  node_graph_builder["Navigation graph<br/>[graph_builder.py]"]
end

subgraph group_navigation["Robot navigation"]
  node_planner["Path planner<br/>[path_planner.py]"]
  node_follower["Path follower<br/>[path_follower.py]"]
  node_robot_handler["Robot lidar handler<br/>[robot_handler.py]"]
end

subgraph group_perception["Perception and control"]
  node_marker_detection["Marker detection"]
  node_marker_pose["Marker pose<br/>[marker_pose.py]"]
  node_aruco["ArUco node<br/>[aruco_node.py]"]
  node_wall_follower["Wall follower<br/>[wall_follower.py]"]
  node_controller["Controller<br/>[controller.py]"]
  node_map_marker["Map markers<br/>[map_marker.py]"]
  node_image_display["Image display<br/>[image_display.py]"]
end

node_operator(("Operator"))

node_operator -->|"starts"| node_launch
node_launch -.->|"starts"| node_gazebo
node_launch -->|"starts"| node_map_server
node_launch -->|"starts"| node_coordinator
node_launch -.->|"starts"| node_planner
node_coordinator -->|"subscribes map"| node_map_server
node_coordinator -->|"uses analysis"| node_coverage
node_coordinator -->|"builds graph"| node_graph_builder
node_graph_builder -->|"uses settings"| node_coverage
node_coordinator -.->|"publishes graph"| node_planner
node_planner -.->|"publishes route"| node_follower
node_launch -.->|"spawns robots"| node_robot_handler

click node_launch "https://github.com/ebbehj/robot_competition/blob/main/launch/rescue_robots_w1.launch.py"
click node_gazebo "https://github.com/ebbehj/robot_competition/blob/main/worlds/dat160_w1.world"
click node_robot_models "https://github.com/ebbehj/robot_competition/tree/main/models"
click node_map_server "https://github.com/ebbehj/robot_competition/blob/main/maps/map_dat160_w1.yaml"
click node_coordinator "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/coordinator.py"
click node_coverage "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/coverage_map.py"
click node_graph_builder "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/graph_builder.py"
click node_planner "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/path_planner.py"
click node_follower "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/path_follower.py"
click node_robot_handler "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/robot_handler.py"
click node_marker_detection "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/marker_detection.py"
click node_marker_pose "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/marker_pose.py"
click node_aruco "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/aruco_node.py"
click node_wall_follower "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/wall_follower.py"
click node_controller "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/controller.py"
click node_map_marker "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/map_marker.py"
click node_image_display "https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/image_display.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_launch,node_gazebo,node_robot_models,node_map_server toneBlue
class node_coordinator,node_coverage,node_graph_builder toneAmber
class node_planner,node_follower,node_robot_handler toneMint
class node_marker_detection,node_marker_pose,node_aruco,node_wall_follower,node_controller,node_map_marker,node_image_display toneRose
class node_operator toneIndigo
```

## Components

### Simulation setup

- [Rescue launch](https://github.com/ebbehj/robot_competition/blob/main/launch/rescue_robots_w1.launch.py): `launch/rescue_robots_w1.launch.py`
- [Gazebo world](https://github.com/ebbehj/robot_competition/blob/main/worlds/dat160_w1.world): `worlds/dat160_w1.world`
- [Robot and scene models](https://github.com/ebbehj/robot_competition/tree/main/models): `models`
- [Map server](https://github.com/ebbehj/robot_competition/blob/main/maps/map_dat160_w1.yaml): `maps/map_dat160_w1.yaml`

### Mapping and coordination

- [Rescue coordinator](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/coordinator.py): `multi_robot_challenge_23/coordinator.py`
- [Coverage analysis](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/coverage_map.py): `multi_robot_challenge_23/coverage_map.py`
- [Navigation graph](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/graph_builder.py): `multi_robot_challenge_23/graph_builder.py`

### Robot navigation

- [Path planner](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/path_planner.py): `multi_robot_challenge_23/path_planner.py`
- [Path follower](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/path_follower.py): `multi_robot_challenge_23/path_follower.py`
- [Robot lidar handler](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/robot_handler.py): `multi_robot_challenge_23/robot_handler.py`

### Perception and control

- [Marker detection](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/marker_detection.py): `multi_robot_challenge_23/marker_detection.py`
- [Marker pose](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/marker_pose.py): `multi_robot_challenge_23/marker_pose.py`
- [ArUco node](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/aruco_node.py): `multi_robot_challenge_23/aruco_node.py`
- [Wall follower](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/wall_follower.py): `multi_robot_challenge_23/wall_follower.py`
- [Controller](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/controller.py): `multi_robot_challenge_23/controller.py`
- [Map markers](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/map_marker.py): `multi_robot_challenge_23/map_marker.py`
- [Image display](https://github.com/ebbehj/robot_competition/blob/main/multi_robot_challenge_23/image_display.py): `multi_robot_challenge_23/image_display.py`

### Other components

- **Operator**

## Connections

- Operator → Rescue launch: starts (evidence: `README.md`)
- Rescue launch → Gazebo world: starts
- Rescue launch → Map server: starts (evidence: `launch/rescue_robots_w1.launch.py`)
- Rescue launch → Rescue coordinator: starts (evidence: `launch/rescue_robots_w1.launch.py`)
- Rescue launch → Path planner: starts
- Rescue coordinator → Map server: subscribes map (evidence: `multi_robot_challenge_23/coordinator.py`)
- Rescue coordinator → Coverage analysis: uses analysis (evidence: `multi_robot_challenge_23/coordinator.py`)
- Rescue coordinator → Navigation graph: builds graph (evidence: `multi_robot_challenge_23/coordinator.py`)
- Navigation graph → Coverage analysis: uses settings (evidence: `multi_robot_challenge_23/graph_builder.py`)
- Rescue coordinator → Path planner: publishes graph
- Path planner → Path follower: publishes route
- Rescue launch → Robot lidar handler: spawns robots
