# xeedjr/ros_gazebo_workshop architecture

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

- Interactive diagram: https://gitdiagram.com/xeedjr/ros_gazebo_workshop
- Repository: https://github.com/xeedjr/ros_gazebo_workshop

## Overview

This is a ROS 2 mobile-robot application with simulation and hardware paths. Its principal workflow launches the robot stack, acquires sensor data, builds and processes maps, then uses detected map features to issue navigation goals. The repository also includes camera and IMU acquisition, Gazebo plugins, and a serial ros2_control hardware interface. The launch file excerpt shows selected node startup and IMU remappings; sampled node code supports the map-processing and navigation flow. Other subsystem wiring is not assumed where source was not shown.

Main entry points: [`data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py) (Stack Launch), [`data/project_ws/src/my_package/my_package/my_node.py`](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/my_package/my_package/my_node.py) (Goal Navigator), [`data/project_ws/src/bno080/bno080/bno080_node.py`](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/bno080/bno080/bno080_node.py) (BNO080 Driver), [`data/project_ws/src/map_process/map_process/my_node.py`](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/map_process/map_process/my_node.py) (Map Processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bringup["Robot Bringup"]
  node_launch["Stack Launch"]
  node_description["Robot Description<br/>[model.urdf.xacro]"]
  node_gazebo["Gazebo World<br/>[diff_drive.sdf]"]
  node_gzplugins["Gazebo Systems<br/>[FullSystem.cc]"]
  node_bridge["ROS-Gazebo Bridge"]
end

subgraph group_sensing["Sensors and Media"]
  node_imu["BNO080 Driver<br/>[bno080_node.py]"]
  node_calibration["IMU Calibration"]
  node_imu_filter["IMU Filter"]
  node_camera["Image Capture<br/>[image_capture.py]"]
  node_compress["Image Compression<br/>[compress_node.py]"]
  node_camera_udp["Camera UDP<br/>[my_node.py]"]
end

subgraph group_mapping["Mapping and Navigation"]
  node_map_process["Map Processing<br/>[my_node.py]"]
  node_mapper["SLAM Mapper"]
  node_navigator["Goal Navigator<br/>[my_node.py]"]
  node_nav2["Nav2 Stack"]
  node_localization["Robot Localization"]
end

subgraph group_runtime["Robot Runtime"]
  node_controller["Controller Manager"]
  node_hardware_api["Hardware Interface API<br/>[hardware_link2.hpp]"]
  node_hardware_impl["Serial Hardware Driver<br/>[hardware_link2.cpp]"]
  node_robot_state["Robot State Publisher"]
end

node_operator(("Operator"))

node_operator -->|"starts stack"| node_launch
node_launch -->|"starts simulation"| node_gazebo
node_launch -->|"starts bridge"| node_bridge
node_launch -->|"starts driver"| node_imu
node_launch -->|"starts node"| node_compress
node_launch -->|"starts node"| node_camera_udp
node_launch -->|"starts node"| node_map_process
node_launch -->|"starts node"| node_navigator
node_launch -->|"starts filter"| node_imu_filter
node_launch -->|"starts localization"| node_localization
node_launch -->|"starts manager"| node_controller
node_launch -->|"starts publisher"| node_robot_state
node_launch -->|"loads description"| node_description
node_launch -.->|"loads plugins"| node_gzplugins
node_imu -->|"publishes IMU data"| node_imu_filter
node_map_process -->|"publishes sorted markers"| node_navigator
node_navigator -->|"sends pose goals"| node_nav2
node_hardware_impl -->|"implements interface"| node_hardware_api

click node_launch "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py"
click node_description "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_description/models/diff_drive_urdf/model.urdf.xacro"
click node_gazebo "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_gazebo/worlds/diff_drive.sdf"
click node_gzplugins "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_gazebo/src/FullSystem.cc"
click node_imu "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/bno080/bno080/bno080_node.py"
click node_calibration "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/bno080/bno080/calibration_node.py"
click node_camera "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/capture/capture/image_capture.py"
click node_compress "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/camera_process2/camera_process2/compress_node.py"
click node_camera_udp "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/camera_udp_publisher/camera_udp_publisher/my_node.py"
click node_map_process "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/map_process/map_process/my_node.py"
click node_navigator "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/my_package/my_package/my_node.py"
click node_hardware_api "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/hardware_link2/include/hardware_link2/hardware_link2.hpp"
click node_hardware_impl "https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/hardware_link2/src/hardware_link2.cpp"

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_description,node_gazebo,node_gzplugins,node_bridge toneBlue
class node_imu,node_calibration,node_imu_filter,node_camera,node_compress,node_camera_udp toneAmber
class node_map_process,node_mapper,node_navigator,node_nav2,node_localization toneMint
class node_controller,node_hardware_api,node_hardware_impl,node_robot_state toneRose
class node_operator toneIndigo
```

## Components

### Robot Bringup

- [Stack Launch](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py): `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`
- [Robot Description](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_description/models/diff_drive_urdf/model.urdf.xacro): `data/project_ws/src/ros_gz_example_description/models/diff_drive_urdf/model.urdf.xacro`
- [Gazebo World](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_gazebo/worlds/diff_drive.sdf): `data/project_ws/src/ros_gz_example_gazebo/worlds/diff_drive.sdf`
- [Gazebo Systems](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/ros_gz_example_gazebo/src/FullSystem.cc): `data/project_ws/src/ros_gz_example_gazebo/src/FullSystem.cc`
- **ROS-Gazebo Bridge**

### Sensors and Media

- [BNO080 Driver](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/bno080/bno080/bno080_node.py): `data/project_ws/src/bno080/bno080/bno080_node.py`
- [IMU Calibration](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/bno080/bno080/calibration_node.py): `data/project_ws/src/bno080/bno080/calibration_node.py`
- **IMU Filter**
- [Image Capture](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/capture/capture/image_capture.py): `data/project_ws/src/capture/capture/image_capture.py`
- [Image Compression](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/camera_process2/camera_process2/compress_node.py): `data/project_ws/src/camera_process2/camera_process2/compress_node.py`
- [Camera UDP](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/camera_udp_publisher/camera_udp_publisher/my_node.py): `data/project_ws/src/camera_udp_publisher/camera_udp_publisher/my_node.py`

### Mapping and Navigation

- [Map Processing](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/map_process/map_process/my_node.py): `data/project_ws/src/map_process/map_process/my_node.py`
- **SLAM Mapper**
- [Goal Navigator](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/my_package/my_package/my_node.py): `data/project_ws/src/my_package/my_package/my_node.py`
- **Nav2 Stack**
- **Robot Localization**

### Robot Runtime

- **Controller Manager**
- [Hardware Interface API](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/hardware_link2/include/hardware_link2/hardware_link2.hpp): `data/project_ws/src/hardware_link2/include/hardware_link2/hardware_link2.hpp`
- [Serial Hardware Driver](https://github.com/xeedjr/ros_gazebo_workshop/blob/main/data/project_ws/src/hardware_link2/src/hardware_link2.cpp): `data/project_ws/src/hardware_link2/src/hardware_link2.cpp`
- **Robot State Publisher**

### Other components

- **Operator**

## Connections

- Operator → Stack Launch: starts stack (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Gazebo World: starts simulation (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → ROS-Gazebo Bridge: starts bridge (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → BNO080 Driver: starts driver (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Image Compression: starts node (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Camera UDP: starts node (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Map Processing: starts node (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Goal Navigator: starts node (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → IMU Filter: starts filter (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Robot Localization: starts localization (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Controller Manager: starts manager (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Robot State Publisher: starts publisher (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Robot Description: loads description (evidence: `data/project_ws/src/ros_gz_example_bringup/launch/diff_drive.launch.py`)
- Stack Launch → Gazebo Systems: loads plugins
- BNO080 Driver → IMU Filter: publishes IMU data
- Map Processing → Goal Navigator: publishes sorted markers (evidence: `data/project_ws/src/map_process/map_process/my_node.py`)
- Goal Navigator → Nav2 Stack: sends pose goals (evidence: `data/project_ws/src/my_package/my_package/my_node.py`)
- Serial Hardware Driver → Hardware Interface API: implements interface (evidence: `data/project_ws/src/hardware_link2/src/hardware_link2.cpp`)
