# raed-houimli/robonavai architecture

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

- Interactive diagram: https://gitdiagram.com/raed-houimli/robonavai
- Repository: https://github.com/raed-houimli/robonavai

## Overview

AutonomBot is a ROS 2 indoor autonomous mobile robot. Operators launch a simulated or real robot, provide navigation goals, and use Nav2 for planning and obstacle avoidance. The repository also includes SLAM and known-pose mapping, camera-based object detection, ultrasonic localization, and Jetson sensor and motor interfaces. The graph preserves these documented capabilities; some subsystem links are supported only by the README because their launch or implementation files were not excerpted.

Main entry points: [`src/autonombot_launch/launch/real_robot.launch.py`](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_launch/launch/real_robot.launch.py) (Robot Launch), [`src/autonombot_vision/autonombot_vision/advanced_vision_navigator.py`](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/advanced_vision_navigator.py) (Vision Navigator), [`src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py`](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py) (Jetson Sensors), [`src/autonombot_launch/launch/simulated_robot.launch.py`](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_launch/launch/simulated_robot.launch.py) (Simulation Launch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bringup["Robot Bringup"]
  node_robot_launch["Robot Launch"]
  node_sim_launch["Simulation Launch"]
  node_gazebo["Gazebo Simulation<br/>[gazebo.launch.py]"]
end

subgraph group_hardware["Hardware and Sensors"]
  node_drivers["Wheel Odometry"]
  node_hardware_interface["Motor Interface"]
  node_sensor_manager["Jetson Sensors"]
  node_ultrasonic_driver["Ultrasonic Driver<br/>[hcsr04_driver.py]"]
end

subgraph group_perception["Perception and Localization"]
  node_vision_nav["Vision Navigator"]
  node_vision_detector["YOLO Detection<br/>[yolo_detector.py]"]
  node_costmap["Vision Costmap"]
  node_ultra_localization["Ultrasonic Localization"]
  node_position_constraint["Position Constraint"]
end

subgraph group_mapping["Mapping"]
  node_slam["SLAM<br/>[slam.launch.py]"]
  node_known_pose_map["Known-Pose Mapping"]
end

subgraph group_navigation["Navigation"]
  node_nav_launch["Navigation Launch"]
  node_nav2["Nav2 Stack"]
end

node_operator(("Operator"))
node_camera["RealSense Camera"]
node_lidar["LiDAR"]

node_operator -->|"launches"| node_robot_launch
node_operator -->|"launches"| node_sim_launch
node_robot_launch -->|"includes"| node_drivers
node_robot_launch -->|"starts optionally"| node_vision_nav
node_robot_launch -->|"includes"| node_nav_launch
node_sim_launch -.->|"starts"| node_gazebo
node_robot_launch -->|"starts driver"| node_camera
node_robot_launch -->|"starts driver"| node_lidar
node_sensor_manager -->|"reads streams"| node_camera
node_sensor_manager -->|"reads scans"| node_lidar
node_ultrasonic_driver -.->|"supplies ranges"| node_ultra_localization
node_camera -->|"supplies images"| node_vision_nav
node_vision_nav -.->|"detects objects"| node_vision_detector
node_vision_nav -.->|"provides obstacles"| node_costmap
node_lidar -->|"supplies scans"| node_known_pose_map
node_nav_launch -->|"starts servers"| node_nav2
node_slam -.->|"supports mapping navigation"| node_nav2
node_operator -->|"sends goals"| node_nav2
node_nav2 -.->|"commands robot"| node_hardware_interface
node_ultra_localization -.->|"constrains position"| node_position_constraint

click node_robot_launch "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_launch/launch/real_robot.launch.py"
click node_sim_launch "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_launch/launch/simulated_robot.launch.py"
click node_gazebo "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_description/launch/gazebo.launch.py"
click node_drivers "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_drivers/autonombot_drivers/noisy_controller.py"
click node_hardware_interface "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/src/autonombot_interface.cpp"
click node_sensor_manager "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py"
click node_ultrasonic_driver "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/autonombot_firmware/hcsr04_driver.py"
click node_vision_nav "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/advanced_vision_navigator.py"
click node_vision_detector "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/yolo_detector.py"
click node_costmap "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/vision_costmap_updater.py"
click node_ultra_localization "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_localization/autonombot_localization/ultrasonic_localization.py"
click node_position_constraint "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_localization/autonombot_localization/ultrasonic_position_constraint.py"
click node_slam "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_mapping/launch/slam.launch.py"
click node_known_pose_map "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_mapping/autonombot_mapping/mapping_with_known_poses.py"
click node_nav_launch "https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_navigation/launch/navigation.launch.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_robot_launch,node_sim_launch,node_gazebo toneBlue
class node_drivers,node_hardware_interface,node_sensor_manager,node_ultrasonic_driver toneAmber
class node_vision_nav,node_vision_detector,node_costmap,node_ultra_localization,node_position_constraint toneMint
class node_slam,node_known_pose_map toneRose
class node_nav_launch,node_nav2,node_operator,node_camera,node_lidar toneIndigo
```

## Components

### Robot Bringup

- [Robot Launch](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_launch/launch/real_robot.launch.py): `src/autonombot_launch/launch/real_robot.launch.py`
- [Simulation Launch](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_launch/launch/simulated_robot.launch.py): `src/autonombot_launch/launch/simulated_robot.launch.py`
- [Gazebo Simulation](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_description/launch/gazebo.launch.py): `src/autonombot_description/launch/gazebo.launch.py`

### Hardware and Sensors

- [Wheel Odometry](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_drivers/autonombot_drivers/noisy_controller.py): `src/autonombot_drivers/autonombot_drivers/noisy_controller.py`
- [Motor Interface](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/src/autonombot_interface.cpp): `src/autonombot_firmware/src/autonombot_interface.cpp`
- [Jetson Sensors](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py): `src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py`
- [Ultrasonic Driver](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_firmware/autonombot_firmware/hcsr04_driver.py): `src/autonombot_firmware/autonombot_firmware/hcsr04_driver.py`

### Perception and Localization

- [Vision Navigator](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/advanced_vision_navigator.py): `src/autonombot_vision/autonombot_vision/advanced_vision_navigator.py`
- [YOLO Detection](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/yolo_detector.py): `src/autonombot_vision/autonombot_vision/yolo_detector.py`
- [Vision Costmap](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_vision/autonombot_vision/vision_costmap_updater.py): `src/autonombot_vision/autonombot_vision/vision_costmap_updater.py`
- [Ultrasonic Localization](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_localization/autonombot_localization/ultrasonic_localization.py): `src/autonombot_localization/autonombot_localization/ultrasonic_localization.py`
- [Position Constraint](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_localization/autonombot_localization/ultrasonic_position_constraint.py): `src/autonombot_localization/autonombot_localization/ultrasonic_position_constraint.py`

### Mapping

- [SLAM](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_mapping/launch/slam.launch.py): `src/autonombot_mapping/launch/slam.launch.py`
- [Known-Pose Mapping](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_mapping/autonombot_mapping/mapping_with_known_poses.py): `src/autonombot_mapping/autonombot_mapping/mapping_with_known_poses.py`

### Navigation

- [Navigation Launch](https://github.com/raed-houimli/robonavai/blob/main/src/autonombot_navigation/launch/navigation.launch.py): `src/autonombot_navigation/launch/navigation.launch.py`
- **Nav2 Stack**

### Other components

- **Operator**
- **RealSense Camera**
- **LiDAR**

## Connections

- Operator → Robot Launch: launches
- Operator → Simulation Launch: launches
- Robot Launch → Wheel Odometry: includes (evidence: `src/autonombot_launch/launch/real_robot.launch.py`)
- Robot Launch → Vision Navigator: starts optionally (evidence: `src/autonombot_launch/launch/real_robot.launch.py`)
- Robot Launch → Navigation Launch: includes (evidence: `src/autonombot_launch/launch/real_robot.launch.py`)
- Simulation Launch → Gazebo Simulation: starts
- Robot Launch → RealSense Camera: starts driver (evidence: `src/autonombot_launch/launch/real_robot.launch.py`)
- Robot Launch → LiDAR: starts driver (evidence: `src/autonombot_launch/launch/real_robot.launch.py`)
- Jetson Sensors → RealSense Camera: reads streams (evidence: `src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py`)
- Jetson Sensors → LiDAR: reads scans (evidence: `src/autonombot_firmware/autonombot_firmware/jetson_sensor_manager.py`)
- Ultrasonic Driver → Ultrasonic Localization: supplies ranges
- RealSense Camera → Vision Navigator: supplies images (evidence: `src/autonombot_vision/autonombot_vision/advanced_vision_navigator.py`)
- Vision Navigator → YOLO Detection: detects objects
- Vision Navigator → Vision Costmap: provides obstacles
- LiDAR → Known-Pose Mapping: supplies scans (evidence: `src/autonombot_mapping/autonombot_mapping/mapping_with_known_poses.py`)
- Navigation Launch → Nav2 Stack: starts servers (evidence: `src/autonombot_navigation/launch/navigation.launch.py`)
- SLAM → Nav2 Stack: supports mapping navigation
- Operator → Nav2 Stack: sends goals
- Nav2 Stack → Motor Interface: commands robot
- Ultrasonic Localization → Position Constraint: constrains position
