This repository contains a ROS 2 workspace for a simulated mobile robot with Gazebo, RViz, SLAM, perception, and exploration capabilities. The project is organized as a set of ROS packages that together provide a basic autonomous navigation and exploration stack.
The workspace includes:
- a simulated robot model and URDF/Xacro description,
- Gazebo world and maze generation,
- robot spawning and sensor bridge setup,
- SLAM integration,
- camera-based target perception,
- simple control logic,
- and frontier-based exploration behavior.
The main packages are:
- robot_bringup: launch orchestration
- robot_description: robot model and RViz configuration
- robot_simulation: Gazebo simulation and robot spawn
- robot_world: maze world generation
- robot_slam: SLAM launch
- robot_perception: visual target detection
- robot_control: simple target-following control
- robot_behaviours: exploration, path planning, and path following
This project is intended to run in a ROS 2 environment. Make sure you have a working ROS 2 installation with the usual desktop or simulation dependencies.
Install Python dependencies from the workspace root:
python3 -m pip install -r requirements.txtFrom the workspace root:
colcon buildIf you are using a shell environment that requires sourcing the workspace each time, run:
source install/setup.bashThe maze explorer is launched in several steps.
Run the bringup launch file:
ros2 launch robot_bringup bringup.launch.pyThis starts the Gazebo window and RViz.
In a new terminal, run:
ros2 launch robot_simulation spawn_robot.launch.pyThis spawns the robot into the Gazebo world and wires up the simulated sensors.
In another terminal, run:
ros2 launch robot_slam slam.launch.pyIn another terminal, run:
ros2 launch robot_behaviours exploration.launch.pyThis starts the frontier detector, path generator, and path follower nodes.
- The most important navigation-related package is robot_behaviours.
- The robot uses Gazebo + ROS-GZ bridges for simulation and RViz for visualization.
- If you encounter missing package errors, make sure the workspace has been built and sourced correctly.