Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/qualcomm-qrb-ros/qrb_ros_simulation/llms.txt

Use this file to discover all available pages before exploring further.

QRB ROS Simulation ships five pre-built Gazebo world environments as SDF files. Each world provides a different physical layout suited to different testing scenarios. The default world is warehouse, which loads automatically when no world_model argument is specified. You can switch worlds at launch time without rebuilding or modifying any source files.

Available worlds

The world files are located in the qrb_ros_sim_gazebo/worlds/ directory of the installed package.
World modelFileDescription
warehousewarehouse.sdfDefault indoor warehouse environment. A large enclosed space with shelving and open floor area, suited for general AMR navigation and obstacle avoidance testing.
warehouse_followme_path1warehouse_followme_path1.sdfWarehouse variant with a pre-defined navigation path. Designed for follow-me and waypoint-following scenarios.
warehouse_followme_path2warehouse_followme_path2.sdfSecond warehouse variant with an alternative pre-defined navigation path for follow-me testing.
officeoffice.sdfIndoor office layout with rooms, corridors, and furniture. Suited for testing navigation in tighter, more structured environments.
ionicionic.sdfAlternative environment for general simulation and sensor testing.

Selecting a world

Pass the world_model argument to any robot launch file to choose the world. Specify the filename without the .sdf extension:
ros2 launch qrb_ros_sim_gazebo gazebo_robot_base.launch.py world_model:=office
ros2 launch qrb_ros_sim_gazebo gazebo_robot_base.launch.py world_model:=warehouse_followme_path1
The world_model parameter can also be set in a YAML launch config file:
world_model: "office"
The world_model value must match the SDF filename exactly (case-sensitive), without the .sdf extension. For example, use warehouse_followme_path1, not warehouse_followme_path1.sdf or Warehouse_Followme_Path1.
The two warehouse_followme_path worlds are variants of the standard warehouse environment with embedded path markers or waypoints for follow-me navigation scenarios. Use them when developing or testing autonomous following behavior that relies on a known trajectory.

Build docs developers (and LLMs) love