# rajagopal95/bumpy_ws architecture

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

- Interactive diagram: https://gitdiagram.com/rajagopal95/bumpy_ws
- Repository: https://github.com/rajagopal95/bumpy_ws

## Overview

bumpy_ws is a ROS 2 mobile-robot platform. Its main workflow brings up robot description, odometry/control, and sensors; LiDAR and fused odometry support SLAM and mapping, while Nav2 provides autonomous motion. Separate branches cover operator teleoperation, sensor/dashboard capabilities, and multi-robot formation control. Several capabilities are documented but their launch wiring or implementation was not sampled, so those connections are omitted or marked unverified.

Main entry points: [`src/bumpy_firmware/bumpy_firmware/motor_control.py`](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/motor_control.py) (Motor control), [`src/bumpy_bringup/launch/bringup.launch.py`](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_bringup/launch/bringup.launch.py) (Bringup launch), [`src/bumpy_bringup/launch/minimal.launch.py`](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_bringup/launch/minimal.launch.py) (Minimal launch), [`src/ydlidar_ros2_driver/src/ydlidar_ros2_driver_node.cpp`](https://github.com/rajagopal95/bumpy_ws/blob/main/src/ydlidar_ros2_driver/src/ydlidar_ros2_driver_node.cpp) (YDLidar driver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bringup["Robot bringup"]
  node_bringup_launch["Bringup launch<br/>[bringup.launch.py]"]
  node_minimal_launch["Minimal launch<br/>[minimal.launch.py]"]
  node_description_launch["Robot description<br/>[robot.launch.py]"]
  node_lidar["YDLidar driver"]
end

subgraph group_firmware["Control and sensing"]
  node_diff_tf["Encoder odometry<br/>[diff_tf.py]"]
  node_motor["Motor control<br/>[motor_control.py]"]
  node_ticks["Tick publisher<br/>[tick_pub.py]"]
  node_teleop["Controller teleop<br/>[teleop.py]"]
  node_imu["IMU node<br/>[imu.py]"]
  node_camera["Camera node<br/>[camera.py]"]
  node_camera_tf["Camera transform<br/>[camera_tf_pub.py]"]
  node_gas["Gas sensing<br/>[gas_sensor_node.py]"]
end

subgraph group_mapping["Mapping and navigation"]
  node_slam_toolbox["slam_toolbox launch<br/>[slam.launch.py]"]
  node_cartographer["Cartographer launch"]
  node_map_save["Map saving<br/>[save_map.launch.py]"]
  node_navigation["Nav2 launch"]
end

subgraph group_dashboard["Status and dashboard"]
  node_web["Web dashboard<br/>[web_server_node.py]"]
  node_oled["OLED display<br/>[oled.py]"]
  node_status["Robot status<br/>[robot_status.py]"]
  node_leader["Leader election<br/>[leader_ele.py]"]
end

subgraph group_coordination["Multi-robot coordination"]
  node_formation["Formation control<br/>[3robot.py]"]
  node_obstacle["Formation obstacles<br/>[obstacle.py]"]
end

node_operator(("Robot operator"))

node_bringup_launch -->|"starts description"| node_description_launch
node_bringup_launch -->|"starts control"| node_motor
node_bringup_launch -->|"starts sensors"| node_imu
node_minimal_launch -->|"includes launch"| node_description_launch
node_minimal_launch -->|"includes launch"| node_motor
node_minimal_launch -->|"starts node"| node_imu
node_ticks -.->|"encoder ticks"| node_diff_tf
node_diff_tf -.->|"odometry feedback"| node_motor
node_teleop -.->|"velocity commands"| node_motor
node_lidar -.->|"scan input"| node_slam_toolbox
node_lidar -->|"scan input"| node_cartographer
node_slam_toolbox -.->|"map output"| node_map_save
node_cartographer -.->|"map output"| node_map_save
node_navigation -.->|"velocity commands"| node_motor
node_operator -->|"steers robot"| node_teleop
node_operator -.->|"sets navigation"| node_navigation
node_web -.->|"publishes commands"| node_motor
node_leader -.->|"coordinates robots"| node_formation
node_formation -.->|"obstacle handling"| node_obstacle

click node_bringup_launch "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_bringup/launch/bringup.launch.py"
click node_minimal_launch "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_bringup/launch/minimal.launch.py"
click node_description_launch "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_description/launch/robot.launch.py"
click node_lidar "https://github.com/rajagopal95/bumpy_ws/blob/main/src/ydlidar_ros2_driver/src/ydlidar_ros2_driver_node.cpp"
click node_diff_tf "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/diff_tf.py"
click node_motor "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/motor_control.py"
click node_ticks "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/tick_pub.py"
click node_teleop "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/teleop.py"
click node_imu "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/imu.py"
click node_camera "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/camera.py"
click node_camera_tf "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/camera_tf_pub.py"
click node_gas "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/gas_sensor_node.py"
click node_slam_toolbox "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_slam/launch/slam.launch.py"
click node_cartographer "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_slam/launch/cartographer.launch.py"
click node_map_save "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_slam/launch/save_map.launch.py"
click node_navigation "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_navigation/launch/navigation.launch.py"
click node_web "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/web_server_node.py"
click node_oled "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/oled.py"
click node_status "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/robot_status.py"
click node_leader "https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/leader_ele.py"
click node_formation "https://github.com/rajagopal95/bumpy_ws/blob/main/src/formation_control/formation_control/3robot.py"
click node_obstacle "https://github.com/rajagopal95/bumpy_ws/blob/main/src/formation_control/formation_control/obstacle.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_bringup_launch,node_minimal_launch,node_description_launch,node_lidar toneBlue
class node_diff_tf,node_motor,node_ticks,node_teleop,node_imu,node_camera,node_camera_tf,node_gas toneAmber
class node_slam_toolbox,node_cartographer,node_map_save,node_navigation toneMint
class node_web,node_oled,node_status,node_leader toneRose
class node_formation,node_obstacle,node_operator toneIndigo
```

## Components

### Robot bringup

- [Bringup launch](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_bringup/launch/bringup.launch.py): `src/bumpy_bringup/launch/bringup.launch.py`
- [Minimal launch](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_bringup/launch/minimal.launch.py): `src/bumpy_bringup/launch/minimal.launch.py`
- [Robot description](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_description/launch/robot.launch.py): `src/bumpy_description/launch/robot.launch.py`
- [YDLidar driver](https://github.com/rajagopal95/bumpy_ws/blob/main/src/ydlidar_ros2_driver/src/ydlidar_ros2_driver_node.cpp): `src/ydlidar_ros2_driver/src/ydlidar_ros2_driver_node.cpp`

### Control and sensing

- [Encoder odometry](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/diff_tf.py): `src/bumpy_firmware/bumpy_firmware/diff_tf.py`
- [Motor control](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/motor_control.py): `src/bumpy_firmware/bumpy_firmware/motor_control.py`
- [Tick publisher](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/tick_pub.py): `src/bumpy_firmware/bumpy_firmware/tick_pub.py`
- [Controller teleop](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_firmware/bumpy_firmware/teleop.py): `src/bumpy_firmware/bumpy_firmware/teleop.py`
- [IMU node](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/imu.py): `src/bumpy_sensors/bumpy_sensors/imu.py`
- [Camera node](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/camera.py): `src/bumpy_sensors/bumpy_sensors/camera.py`
- [Camera transform](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/camera_tf_pub.py): `src/bumpy_sensors/bumpy_sensors/camera_tf_pub.py`
- [Gas sensing](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/gas_sensor_node.py): `src/bumpy_sensors/bumpy_sensors/gas_sensor_node.py`

### Mapping and navigation

- [slam_toolbox launch](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_slam/launch/slam.launch.py): `src/bumpy_slam/launch/slam.launch.py`
- [Cartographer launch](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_slam/launch/cartographer.launch.py): `src/bumpy_slam/launch/cartographer.launch.py`
- [Map saving](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_slam/launch/save_map.launch.py): `src/bumpy_slam/launch/save_map.launch.py`
- [Nav2 launch](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_navigation/launch/navigation.launch.py): `src/bumpy_navigation/launch/navigation.launch.py`

### Status and dashboard

- [Web dashboard](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/web_server_node.py): `src/bumpy_sensors/bumpy_sensors/web_server_node.py`
- [OLED display](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/oled.py): `src/bumpy_sensors/bumpy_sensors/oled.py`
- [Robot status](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/robot_status.py): `src/bumpy_sensors/bumpy_sensors/robot_status.py`
- [Leader election](https://github.com/rajagopal95/bumpy_ws/blob/main/src/bumpy_sensors/bumpy_sensors/leader_ele.py): `src/bumpy_sensors/bumpy_sensors/leader_ele.py`

### Multi-robot coordination

- [Formation control](https://github.com/rajagopal95/bumpy_ws/blob/main/src/formation_control/formation_control/3robot.py): `src/formation_control/formation_control/3robot.py`
- [Formation obstacles](https://github.com/rajagopal95/bumpy_ws/blob/main/src/formation_control/formation_control/obstacle.py): `src/formation_control/formation_control/obstacle.py`

### Other components

- **Robot operator**

## Connections

- Bringup launch → Robot description: starts description (evidence: `README.md`)
- Bringup launch → Motor control: starts control (evidence: `README.md`)
- Bringup launch → IMU node: starts sensors (evidence: `README.md`)
- Minimal launch → Robot description: includes launch (evidence: `src/bumpy_bringup/launch/minimal.launch.py`)
- Minimal launch → Motor control: includes launch (evidence: `src/bumpy_bringup/launch/minimal.launch.py`)
- Minimal launch → IMU node: starts node (evidence: `src/bumpy_bringup/launch/minimal.launch.py`)
- Tick publisher → Encoder odometry: encoder ticks
- Encoder odometry → Motor control: odometry feedback
- Controller teleop → Motor control: velocity commands
- YDLidar driver → slam_toolbox launch: scan input
- YDLidar driver → Cartographer launch: scan input (evidence: `src/bumpy_slam/launch/cartographer.launch.py`)
- slam_toolbox launch → Map saving: map output
- Cartographer launch → Map saving: map output
- Nav2 launch → Motor control: velocity commands
- Robot operator → Controller teleop: steers robot (evidence: `README.md`)
- Robot operator → Nav2 launch: sets navigation
- Web dashboard → Motor control: publishes commands
- Leader election → Formation control: coordinates robots
- Formation control → Formation obstacles: obstacle handling
