# dfki-ni/mir_robot architecture

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

- Interactive diagram: https://gitdiagram.com/dfki-ni/mir_robot
- Repository: https://github.com/dfki-ni/mir_robot

## Overview

mir_robot is a ROS 1 driver and configuration suite for MiR mobile robots, with both real-robot and Gazebo use. The documented simulation workflow starts a world, localizes or maps the robot, then launches move_base so an operator can send a navigation goal from RViz. The repository also supplies robot descriptions, ROS interfaces, simulation assets, navigation configuration, and DWB planner critics. Source excerpts confirm the bridge-to-transport implementation and critic behavior; several package connections below are documented only by the README, so unsampled internals are represented at subsystem level.

Main entry points: [`mir_driver/nodes/mir_bridge.py`](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_driver/nodes/mir_bridge.py) (MiR ROS bridge), [`mir_navigation/launch/move_base.xml`](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_navigation/launch/move_base.xml) (move_base config), [`mir_navigation/launch/start_planner.launch`](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_navigation/launch/start_planner.launch) (Planner bringup), [`mir_gazebo/launch`](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_gazebo/launch) (Gazebo worlds)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation"]
  node_gazebo["Gazebo worlds"]
  node_robot_model["Robot description"]
  node_sim_localization["Fake localization"]
  node_maps["Maps"]
end

subgraph group_robot["Robot integration"]
  node_robot_driver["MiR ROS bridge<br/>[mir_bridge.py]"]
  node_rosbridge_transport["Rosbridge transport<br/>[rosbridge.py]"]
  node_driver_helpers["Driver helpers"]
end

subgraph group_navigation["Navigation"]
  node_map_localization["AMCL / mapping"]
  node_planner_launch["Planner bringup"]
  node_move_base["move_base config<br/>[move_base.xml]"]
  node_planner_params["Planner parameters"]
  node_motion_primitives["Motion primitives"]
  node_dwb_critics["DWB critics"]
end

subgraph group_interfaces["ROS interfaces"]
  node_messages["Robot messages"]
  node_actions["Robot actions"]
  node_motor_interfaces["Motor interfaces"]
end

node_operator(("Operator"))
node_robot(("MiR robot"))

node_operator -->|"starts world"| node_gazebo
node_gazebo -->|"loads description"| node_robot_model
node_operator -->|"starts localization"| node_sim_localization
node_operator -->|"starts localization"| node_map_localization
node_operator -->|"starts planner"| node_planner_launch
node_maps -->|"supplies map"| node_planner_launch
node_planner_launch -->|"launches"| node_move_base
node_planner_params -.->|"configures"| node_move_base
node_motion_primitives -.->|"configures"| node_move_base
node_dwb_critics -->|"scores trajectories"| node_move_base
node_operator -->|"sets goal"| node_move_base
node_robot -->|"exchanges ROS data"| node_robot_driver
node_robot_driver -->|"uses transport"| node_rosbridge_transport
node_robot_driver -.->|"bridges topics"| node_messages
node_robot_driver -->|"bridges goals"| node_actions
node_robot_driver -.->|"uses interfaces"| node_motor_interfaces
node_driver_helpers -.->|"supports bringup"| node_robot_driver

click node_gazebo "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_gazebo/launch"
click node_robot_model "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_description/urdf"
click node_sim_localization "https://github.com/dfki-ni/mir_robot/blob/noetic/mir_gazebo/launch/fake_localization.launch"
click node_map_localization "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_navigation/launch"
click node_maps "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_gazebo/maps"
click node_planner_launch "https://github.com/dfki-ni/mir_robot/blob/noetic/mir_navigation/launch/start_planner.launch"
click node_move_base "https://github.com/dfki-ni/mir_robot/blob/noetic/mir_navigation/launch/move_base.xml"
click node_planner_params "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_navigation/config"
click node_motion_primitives "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_navigation/mprim"
click node_dwb_critics "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_dwb_critics/src"
click node_robot_driver "https://github.com/dfki-ni/mir_robot/blob/noetic/mir_driver/nodes/mir_bridge.py"
click node_rosbridge_transport "https://github.com/dfki-ni/mir_robot/blob/noetic/mir_driver/src/mir_driver/rosbridge.py"
click node_messages "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_msgs/msg"
click node_actions "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_actions/action"
click node_motor_interfaces "https://github.com/dfki-ni/mir_robot/tree/noetic/sdc21x0"
click node_driver_helpers "https://github.com/dfki-ni/mir_robot/tree/noetic/mir_driver/nodes"

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_gazebo,node_robot_model,node_sim_localization,node_maps toneBlue
class node_robot_driver,node_rosbridge_transport,node_driver_helpers toneAmber
class node_map_localization,node_planner_launch,node_move_base,node_planner_params,node_motion_primitives,node_dwb_critics toneMint
class node_messages,node_actions,node_motor_interfaces toneRose
class node_operator,node_robot toneIndigo
```

## Components

### Simulation

- [Gazebo worlds](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_gazebo/launch): `mir_gazebo/launch`
- [Robot description](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_description/urdf): `mir_description/urdf`
- [Fake localization](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_gazebo/launch/fake_localization.launch): `mir_gazebo/launch/fake_localization.launch`
- [Maps](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_gazebo/maps): `mir_gazebo/maps`

### Robot integration

- [MiR ROS bridge](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_driver/nodes/mir_bridge.py): `mir_driver/nodes/mir_bridge.py`
- [Rosbridge transport](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_driver/src/mir_driver/rosbridge.py): `mir_driver/src/mir_driver/rosbridge.py`
- [Driver helpers](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_driver/nodes): `mir_driver/nodes`

### Navigation

- [AMCL / mapping](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_navigation/launch): `mir_navigation/launch`
- [Planner bringup](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_navigation/launch/start_planner.launch): `mir_navigation/launch/start_planner.launch`
- [move_base config](https://github.com/dfki-ni/mir_robot/blob/noetic/mir_navigation/launch/move_base.xml): `mir_navigation/launch/move_base.xml`
- [Planner parameters](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_navigation/config): `mir_navigation/config`
- [Motion primitives](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_navigation/mprim): `mir_navigation/mprim`
- [DWB critics](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_dwb_critics/src): `mir_dwb_critics/src`

### ROS interfaces

- [Robot messages](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_msgs/msg): `mir_msgs/msg`
- [Robot actions](https://github.com/dfki-ni/mir_robot/tree/noetic/mir_actions/action): `mir_actions/action`
- [Motor interfaces](https://github.com/dfki-ni/mir_robot/tree/noetic/sdc21x0): `sdc21x0`

### Other components

- **Operator**
- **MiR robot**

## Connections

- Operator → Gazebo worlds: starts world (evidence: `README.md`)
- Gazebo worlds → Robot description: loads description (evidence: `README.md`)
- Operator → Fake localization: starts localization (evidence: `README.md`)
- Operator → AMCL / mapping: starts localization (evidence: `README.md`)
- Operator → Planner bringup: starts planner (evidence: `README.md`)
- Maps → Planner bringup: supplies map (evidence: `README.md`)
- Planner bringup → move_base config: launches (evidence: `README.md`)
- Planner parameters → move_base config: configures
- Motion primitives → move_base config: configures
- DWB critics → move_base config: scores trajectories (evidence: `README.md`)
- Operator → move_base config: sets goal (evidence: `README.md`)
- MiR robot → MiR ROS bridge: exchanges ROS data (evidence: `README.md`)
- MiR ROS bridge → Rosbridge transport: uses transport (evidence: `mir_driver/nodes/mir_bridge.py`)
- MiR ROS bridge → Robot messages: bridges topics
- MiR ROS bridge → Robot actions: bridges goals (evidence: `mir_driver/nodes/mir_bridge.py`)
- MiR ROS bridge → Motor interfaces: uses interfaces
- Driver helpers → MiR ROS bridge: supports bringup
