Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Change get_started to recommened Gz version per platform for installations #338
Change get_started to recommened Gz version per platform for installations #338
Changes from all commits
084fd2d
d7541ba
6000cb9
53010dc
22eae30
851eac8
0e2492a
File filter
Filter by extension
Conversations
Jump to
There are no files selected for viewing
Getting Started with Gazebo?
Welcome to Gazebo!
When you're ready, follow the next few steps to get up and running with simulation using Gazebo.
Step 1: Install
Each release of Gazebo ships with a new installation tutorial. You can read the latest installation tutorial here. Please visit the main documentation pages for a list of all releases, along with links to their respective installation tutorials.
The recommended installation for new users is the use of binary packages available for the platform to use:
Windows support via conda-forge is not fully functional, there are known runtime problems Gazebo for Windows Issue.
If the desired platform is not listed above or if a particular feature in a given Gazebo release is needed, there is an installation package per release available with all the installation options:
Step 2: Run
After installing Gazebo in Step 1, you can launch Gazebo Sim, a 3D robotics simulator, from a terminal using
This command will launch both the Sim server and Sim GUI with a world that contains three simple shapes.
Add the
-v 4
command line argument to generate error, warning, informational, and debugging messages on the console.Gazebo Sim can also be run headless, i.e. without the GUI, by using the
-s
(server only) flag.Similarly, the GUI can be run independently using the
-g
(gui only) flag. On start, the GUI will attempt to connect to a server instance. If a server is not available, then you will see just a blank screen until a server instances is started.Step 3: Create your own world
SDF is used to specify the contents of simulation. Take a look at the available SDF tutorials to get started.
Modifying an existing SDF world is also a good way to get started. Gazebo Sim ships with a number of example SDF worlds that you can freely copy and modify. These example SDF files are installed. Many of the SDF files also have instructions located at the top of the SDF file. The instructions typically contain information about how to run Sim with the SDF file in order to experience a particular feature.
There are a wide variety of simulation resources at your disposal on https://app.gazebosim.org/fuel. If you find a model you'd like to use, then click on the
<>
icon in the model description page, highlighted in the image below, to copy an SDF snippet into your clipboard. This snippet can be pasted directly into your custom SDF file.Step 4: Explore and learn
This tutorial has covered the basics of getting started with Gazebo. Starting with Citadel, there are more versioned tutorials covering the basics of the GUI, creating worlds and robots, and more.
Each Gazebo library also has a set of tutorials and examples. Explore these resources, and don't forget to ask questions and find solutions at answers.gazebosim.org.