Gazebo world creation in ROS - Mini Project: Build & Apply

Gazebo World Creation

📖 Scenario: You are building a simple Gazebo simulation world for a robot to explore. This world will have a flat ground plane and a few objects placed at specific locations.

🎯 Goal: Create a Gazebo world file with a ground plane and two boxes placed at given coordinates. You will define the world structure step-by-step using XML syntax inside a ROS package.

📋 What You'll Learn

Create a basic Gazebo world XML structure

Add a ground plane model to the world

Add two box models with specific sizes and positions

Include a light source for the scene

💡 Why This Matters

🌍 Real World

Creating Gazebo worlds is essential for testing robots in simulated environments before deploying them in real life. This helps save time and avoid damage.

💼 Career

Robotics engineers and developers use Gazebo world files to design and test robot behaviors, sensor setups, and environment interactions.

1

Create the basic Gazebo world XML structure

Create a file named simple_world.world and write the root <sdf version="1.6"> tag with a nested <world name="default"> tag. Close both tags properly.

ROS

Hint

Start with the root <sdf> tag and add a <world> tag inside it.

2

Add a ground plane model

Inside the <world> tag, add a <include> tag that includes the model named ground_plane. Use the <uri> tag with value model://ground_plane.

ROS

Hint

Use the <include> tag to add the ground plane model from Gazebo's default models.

3

Add two box models with size and position

Add two <model> tags inside the <world> tag. Each model should have a unique <name> (box1 and box2). Inside each model, add a <pose> tag with positions 1 0 0.5 0 0 0 for box1 and -1 0 0.5 0 0 0 for box2. Also add a <link> with a <collision> and <visual> tag each containing a <geometry> with a <box> of size 1 1 1.

ROS

  
    
      model://ground_plane
    
    
  

Hint

Define each box model with a <pose> for position and a <link> containing <collision> and <visual> geometry boxes.

4

Add a directional light source

Inside the <world> tag, add a <light> tag with name="sun" and type="directional". Add a <pose> tag with value 0 0 10 0 0 0 and a <direction> tag with value -0.5 0.5 -1.

ROS

  
    
      model://ground_plane
    
    
      1 0 0.5 0 0 0
      
        
          
            
              1 1 1
            
          
        
        
          
            
              1 1 1
            
          
        
      
    
    
      -1 0 0.5 0 0 0
      
        
          
            
              1 1 1
            
          
        
        
          
            
              1 1 1
            
          
        
      
    
    
  

Hint

Add a <light> tag with the specified attributes and child tags inside the <world> tag.

Practice

1. What is the main purpose of a Gazebo world file in ROS simulations?

easy

A. To compile ROS packages

B. To define the simulation environment including models and lights

C. To write robot control algorithms

D. To visualize sensor data from the robot

Solution

1. Step 1: Understand Gazebo world file role

   A Gazebo world file is an XML file that describes the simulation environment, including models, lights, and their positions.

2. Step 2: Differentiate from other ROS files

   Robot control algorithms and package compilation are handled elsewhere, not in the world file.

3. Final Answer:

   To define the simulation environment including models and lights -> Option B

4. Quick Check:

   Gazebo world = simulation environment setup [OK]

Hint: World files describe environment setup, not robot code [OK]

Common Mistakes:

• Confusing world files with robot control scripts
• Thinking world files compile packages
• Assuming world files handle sensor visualization

2. Which XML tag correctly starts a Gazebo world definition?

easy

A. <world>

B. <simulation>

C. <environment>

D. <gazebo>

Solution

1. Step 1: Identify the root tag for Gazebo worlds

   The root tag for defining a Gazebo world is <world>, which contains all environment elements.

2. Step 2: Exclude incorrect tags

   Tags like <simulation>, <environment>, and <gazebo> are not valid root tags for Gazebo world files.

3. Final Answer:

   <world> -> Option A

4. Quick Check:

   Gazebo world root tag = <world> [OK]

Hint: World files always start with <world> tag [OK]

Common Mistakes:

• Using <simulation> or <environment> instead of <world>
• Confusing <gazebo> tag as root
• Omitting the root tag entirely

3. Given this snippet inside a Gazebo world file:

<model name="box">
  <pose>1 2 0 0 0 0</pose>
</model>

What does the <pose> tag specify?

medium

A. The color of the model

B. The size of the model

C. The position and orientation of the model

D. The physics properties of the model

Solution

1. Step 1: Understand the <pose> tag meaning

   The <pose> tag defines the position (x, y, z) and orientation (roll, pitch, yaw) of the model in the world.

2. Step 2: Match values to meaning

   Values "1 2 0 0 0 0" mean x=1, y=2, z=0 position and zero rotation angles.

3. Final Answer:

   The position and orientation of the model -> Option C

4. Quick Check:

   <pose> = position + orientation [OK]

Hint: <pose> always means position and rotation [OK]

Common Mistakes:

• Thinking <pose> sets color or size
• Confusing physics properties with pose
• Ignoring orientation values

4. You wrote this Gazebo world snippet but Gazebo fails to load it:

<world name="default">
  <model name="robot">
    <pose>0 0 0 0 0</pose>
  </model>
</world>

What is the error causing Gazebo to fail?

medium

A. Model name cannot be "robot"

B. The <model> tag must be outside the <world> tag

C. The <world> tag requires a closing slash

D. Missing one value in the <pose> tag; it needs 6 values

Solution

1. Step 1: Check the <pose> tag values

   The <pose> tag requires 6 values: x, y, z, roll, pitch, yaw. Here only 5 are given.

2. Step 2: Verify tag structure

   The <model> tag is correctly inside <world>, and <world> is properly closed. Model name "robot" is valid.

3. Final Answer:

   Missing one value in the <pose> tag; it needs 6 values -> Option D

4. Quick Check:

   <pose> needs 6 numbers [OK]

Hint: <pose> always needs 6 numbers: pos + rotation [OK]

Common Mistakes:

• Providing fewer than 6 numbers in <pose>
• Misplacing <model> outside <world>
• Incorrectly closing <world> tag

5. You want to create a Gazebo world with two models: a box at position (1,0,0) and a sphere at position (0,1,0). Which snippet correctly places both models inside the world?

hard

A.

1 0 0 0 0 0

0 1 0 0 0 0

B.

1 0 0

0 1 0

C.

D.

1 0 0

0 1 0

Solution

1. Step 1: Verify correct <pose> usage inside <model></h4>The <pose> tag must have 6 values and be inside the <model> tag as a child element.

2. Step 2: Check each option for correctness

   <world name="test"> <model name="box"> <pose>1 0 0 0 0 0</pose> </model> <model name="sphere"> <pose>0 1 0 0 0 0</pose> </model> </world> correctly uses <pose> with 6 values inside each <model>. <world name="test"> <model name="box"> <pose>1 0 0</pose> </model> <model name="sphere"> <pose>0 1 0</pose> </model> </world> has only 3 values in <pose>. <world name="test"> <model name="box" pose="1 0 0 0 0 0" /> <model name="sphere" pose="0 1 0 0 0 0" /> </world> incorrectly uses pose as an attribute (not supported). <world name="test"> <model name="box"> <position>1 0 0</position> </model> <model name="sphere"> <position>0 1 0</position> </model> </world> uses <position> tag which is invalid.

3. Final Answer:

   Option A with <pose> tags having 6 values inside each model -> Option A

4. Quick Check:

   Use <pose> with 6 values inside <model> [OK]

Hint: Use <pose> with 6 values inside <model> tags [OK]

Common Mistakes:

• Using <pose> with fewer than 6 values
• Using pose as an attribute instead of a tag
• Using <position> tag instead of <pose>