# men3m-4/mabot architecture

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

- Interactive diagram: https://gitdiagram.com/men3m-4/mabot
- Repository: https://github.com/men3m-4/mabot

## Overview

MABot is a ROS 2 warehouse-robot simulation and autonomy stack. The documented mission workflow starts at the warehouse mission launch, which starts simulation, then navigation, then the waypoint mission; the mission waits for localization and sends Nav2 goals. Separate packages provide robot description, warehouse worlds, AMCL, SLAM mapping/localization, RViz visualization, and waypoint recording/running. The launch and mission excerpts support the main orchestration; some package capabilities are documented in the README but their implementation was not sampled.

Main entry points: [`src/mabot_description/launch/warehouse.launch.py`](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py) (Gazebo Simulation), [`src/mabot_navigation/launch/nav2_bringup.launch.py`](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_navigation/launch/nav2_bringup.launch.py) (Nav2 Stack), [`src/mabot_bringup/launch/warehouse_mission.launch.py`](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/warehouse_mission.launch.py) (Mission Launch), [`src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py`](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py) (Warehouse Mission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bringup["Mission Bringup"]
  node_mission_launch["Mission Launch"]
  node_simulation_launch["Simulation Launch"]
  node_navigation_launch["Navigation Launch"]
end

subgraph group_simulation["Robot Simulation"]
  node_robot_description["Robot Model<br/>[mabot.urdf.xacro]"]
  node_gazebo_launch["Gazebo Simulation"]
  node_warehouse_world["Warehouse World"]
  node_ros_gz_bridge["ROS-Gazebo Bridge<br/>[gz_bridge.yaml]"]
  node_camera_bridge["Camera Bridge"]
  node_rviz["RViz Visualization"]
end

subgraph group_autonomy["Localization Navigation"]
  node_nav2["Nav2 Stack"]
  node_nav_configs["Nav2 Configuration"]
  node_amcl["AMCL Localization<br/>[amcl.launch.py]"]
  node_map_server["Map Server"]
  node_slam_mapping["SLAM Mapping<br/>[mapping.launch.py]"]
  node_slam_localization["SLAM Localization"]
  node_slam_data["Maps and Pose Graphs"]
end

subgraph group_waypoints["Waypoint Missions"]
  node_mission_node["Warehouse Mission"]
  node_waypoint_runner["Waypoint Runner<br/>[waypoint_runner.py]"]
  node_waypoint_recorder["Waypoint Recorder"]
  node_waypoint_data["Waypoint Data"]
end

node_operator(("Operator"))

node_operator -->|"starts mission"| node_mission_launch
node_mission_launch -->|"includes"| node_simulation_launch
node_mission_launch -->|"starts after simulation"| node_navigation_launch
node_mission_launch -->|"starts after navigation"| node_mission_node
node_simulation_launch -.->|"launches simulation"| node_gazebo_launch
node_gazebo_launch -->|"loads model"| node_robot_description
node_gazebo_launch -.->|"loads world"| node_warehouse_world
node_gazebo_launch -->|"configures bridge"| node_ros_gz_bridge
node_gazebo_launch -->|"starts bridge"| node_camera_bridge
node_gazebo_launch -->|"starts visualization"| node_rviz
node_navigation_launch -.->|"launches Nav2"| node_nav2
node_nav2 -->|"loads parameters"| node_nav_configs
node_nav2 -->|"loads map"| node_map_server
node_nav2 -->|"starts localization"| node_amcl
node_slam_mapping -.->|"produces maps"| node_slam_data
node_slam_localization -->|"loads pose graph"| node_slam_data
node_mission_node -.->|"loads waypoints"| node_waypoint_data
node_mission_node -->|"waits for localization"| node_amcl
node_mission_node -->|"sends goals"| node_nav2
node_waypoint_runner -->|"loads waypoints"| node_waypoint_data
node_waypoint_runner -->|"sends goals"| node_nav2
node_waypoint_recorder -.->|"records waypoints"| node_waypoint_data

click node_mission_launch "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/warehouse_mission.launch.py"
click node_simulation_launch "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/simulation.launch.py"
click node_navigation_launch "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/navigation.launch.py"
click node_robot_description "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/urdf/mabot.urdf.xacro"
click node_gazebo_launch "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py"
click node_warehouse_world "https://github.com/men3m-4/mabot/blob/docker-support/src/warehouse_world/worlds/warehouse_storage.sdf"
click node_ros_gz_bridge "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/config/gz_bridge.yaml"
click node_camera_bridge "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py"
click node_rviz "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py"
click node_nav2 "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_navigation/launch/nav2_bringup.launch.py"
click node_nav_configs "https://github.com/men3m-4/mabot/tree/docker-support/src/mabot_navigation/config"
click node_amcl "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_localization/launch/amcl.launch.py"
click node_map_server "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_localization/map/mabot_world_map.yaml"
click node_slam_mapping "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_slam/launch/mapping.launch.py"
click node_slam_localization "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_slam/launch/localization.launch.py"
click node_slam_data "https://github.com/men3m-4/mabot/tree/docker-support/src/mabot_slam/map"
click node_mission_node "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py"
click node_waypoint_runner "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_runner.py"
click node_waypoint_recorder "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_recorder.py"
click node_waypoint_data "https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/config/warehouse_waypoints.yaml"

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_mission_launch,node_simulation_launch,node_navigation_launch toneBlue
class node_robot_description,node_gazebo_launch,node_warehouse_world,node_ros_gz_bridge,node_camera_bridge,node_rviz toneAmber
class node_nav2,node_nav_configs,node_amcl,node_map_server,node_slam_mapping,node_slam_localization,node_slam_data toneMint
class node_mission_node,node_waypoint_runner,node_waypoint_recorder,node_waypoint_data toneRose
class node_operator toneIndigo
```

## Components

### Mission Bringup

- [Mission Launch](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/warehouse_mission.launch.py): `src/mabot_bringup/launch/warehouse_mission.launch.py`
- [Simulation Launch](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/simulation.launch.py): `src/mabot_bringup/launch/simulation.launch.py`
- [Navigation Launch](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_bringup/launch/navigation.launch.py): `src/mabot_bringup/launch/navigation.launch.py`

### Robot Simulation

- [Robot Model](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/urdf/mabot.urdf.xacro): `src/mabot_description/urdf/mabot.urdf.xacro`
- [Gazebo Simulation](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py): `src/mabot_description/launch/warehouse.launch.py`
- [Warehouse World](https://github.com/men3m-4/mabot/blob/docker-support/src/warehouse_world/worlds/warehouse_storage.sdf): `src/warehouse_world/worlds/warehouse_storage.sdf`
- [ROS-Gazebo Bridge](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/config/gz_bridge.yaml): `src/mabot_description/config/gz_bridge.yaml`
- [Camera Bridge](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py): `src/mabot_description/launch/warehouse.launch.py`
- [RViz Visualization](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_description/launch/warehouse.launch.py): `src/mabot_description/launch/warehouse.launch.py`

### Localization Navigation

- [Nav2 Stack](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_navigation/launch/nav2_bringup.launch.py): `src/mabot_navigation/launch/nav2_bringup.launch.py`
- [Nav2 Configuration](https://github.com/men3m-4/mabot/tree/docker-support/src/mabot_navigation/config): `src/mabot_navigation/config`
- [AMCL Localization](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_localization/launch/amcl.launch.py): `src/mabot_localization/launch/amcl.launch.py`
- [Map Server](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_localization/map/mabot_world_map.yaml): `src/mabot_localization/map/mabot_world_map.yaml`
- [SLAM Mapping](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_slam/launch/mapping.launch.py): `src/mabot_slam/launch/mapping.launch.py`
- [SLAM Localization](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_slam/launch/localization.launch.py): `src/mabot_slam/launch/localization.launch.py`
- [Maps and Pose Graphs](https://github.com/men3m-4/mabot/tree/docker-support/src/mabot_slam/map): `src/mabot_slam/map`

### Waypoint Missions

- [Warehouse Mission](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py): `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py`
- [Waypoint Runner](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_runner.py): `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_runner.py`
- [Waypoint Recorder](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_recorder.py): `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_recorder.py`
- [Waypoint Data](https://github.com/men3m-4/mabot/blob/docker-support/src/mabot_warehouse_waypoints/config/warehouse_waypoints.yaml): `src/mabot_warehouse_waypoints/config/warehouse_waypoints.yaml`

### Other components

- **Operator**

## Connections

- Operator → Mission Launch: starts mission (evidence: `README.md`)
- Mission Launch → Simulation Launch: includes (evidence: `src/mabot_bringup/launch/warehouse_mission.launch.py`)
- Mission Launch → Navigation Launch: starts after simulation (evidence: `src/mabot_bringup/launch/warehouse_mission.launch.py`)
- Mission Launch → Warehouse Mission: starts after navigation (evidence: `src/mabot_bringup/launch/warehouse_mission.launch.py`)
- Simulation Launch → Gazebo Simulation: launches simulation
- Gazebo Simulation → Robot Model: loads model (evidence: `src/mabot_description/launch/warehouse.launch.py`)
- Gazebo Simulation → Warehouse World: loads world
- Gazebo Simulation → ROS-Gazebo Bridge: configures bridge (evidence: `src/mabot_description/launch/warehouse.launch.py`)
- Gazebo Simulation → Camera Bridge: starts bridge (evidence: `src/mabot_description/launch/warehouse.launch.py`)
- Gazebo Simulation → RViz Visualization: starts visualization (evidence: `src/mabot_description/launch/warehouse.launch.py`)
- Navigation Launch → Nav2 Stack: launches Nav2
- Nav2 Stack → Nav2 Configuration: loads parameters (evidence: `src/mabot_navigation/launch/nav2_bringup.launch.py`)
- Nav2 Stack → Map Server: loads map (evidence: `src/mabot_navigation/launch/nav2_bringup.launch.py`)
- Nav2 Stack → AMCL Localization: starts localization (evidence: `src/mabot_navigation/launch/nav2_bringup.launch.py`)
- SLAM Mapping → Maps and Pose Graphs: produces maps
- SLAM Localization → Maps and Pose Graphs: loads pose graph (evidence: `src/mabot_slam/launch/localization.launch.py`)
- Warehouse Mission → Waypoint Data: loads waypoints
- Warehouse Mission → AMCL Localization: waits for localization (evidence: `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py`)
- Warehouse Mission → Nav2 Stack: sends goals (evidence: `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/warehouse_mission.py`)
- Waypoint Runner → Waypoint Data: loads waypoints (evidence: `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_runner.py`)
- Waypoint Runner → Nav2 Stack: sends goals (evidence: `src/mabot_warehouse_waypoints/mabot_warehouse_waypoints/waypoint_runner.py`)
- Waypoint Recorder → Waypoint Data: records waypoints
