As an open-source project, ArduPilot/ardupilot_gazebo has picked up 240 stars on GitHub (C++). Plugins and models for vehicle simulation in Gazebo Sim with ArduPilot SITL controllers
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This is the official ArduPilot plugin for Gazebo.
It replaces the previous
ardupilot_gazebo
plugin and provides support for the recent releases of the Gazebo simulator:
Gazebo Garden, Gazebo Harmonic (LTS), Gazebo Ionic and Gazebo Jetty (LTS).
It also adds the following features:
More flexible data exchange between SITL and Gazebo using JSON.
Additional sensors supported.
True simulation lockstepping. It is now possible to use GDB to stop
the Gazebo time for debugging.
Improved 3D rendering using the ogre2 rendering engine.
The project comprises a Gazebo plugin to connect to ArduPilot SITL
(Software In The Loop) and some example models and worlds.
Prerequisites
Gazebo Garden or Harmonic is supported on Ubuntu 22.04 (Jammy).
Harmonic is recommended.
If you are running Ubuntu as a virtual machine you will need at least
Ubuntu 20.04 in order to have the OpenGL support required for the
ogre2 render engine. Gazebo and ArduPilot SITL will also run on macOS
(Big Sur, Monterey and Venturua; Intel and M1 devices).
Follow the instructions for a binary install of
Gazebo Garden or Gazebo Harmonic or Gazebo Ionic
and verify that Gazebo is running correctly.
Set up an ArduPilot development environment.
In the following it is assumed that you are able to run ArduPilot SITL using
the MAVProxy GCS.
Set GZ_VERSION=jetty when building, Harmonic is the default.
Rosdep
Use rosdep with
osrf's rosdep rules
to manage all dependencies. This is driven off of the environment variable GZ_VERSION.
export GZ_VERSION=harmonic # or garden or ionic
sudo bash -c 'wget https://raw.githubusercontent.com/osrf/osrf-rosdep/master/gz/00-gazebo.list -O /etc/ros/rosdep/sources.list.d/00-gazebo.list'
rosdep update
rosdep resolve gz-harmonic # or gz-garden or gz-ionic
# Navigate to your ROS workspace before the next command.
rosdep install --from-paths src --ignore-src -y
Ensure the GZ_VERSION environment variable is set to either
garden, harmonic, ionic or jetty.
Clone the repo and build:
git clone https://github.com/ArduPilot/ardupilot_gazebo
cd ardupilot_gazebo
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo
make -j4
Configure
Set the Gazebo environment variables in your .bashrc or .zshrc or in
the terminal used to run Gazebo.
Terminal
Assuming that you have cloned the repository to $HOME/ardupilot_gazebo:
Reload your terminal with source ~/.bashrc (or source ~/.zshrc on macOS).
Usage
1. Iris quad-copter
Run Gazebo
gz sim -v4 -r iris_runway.sdf
The -v4 parameter is not mandatory, it shows additional information and is
useful for troubleshooting.
Run ArduPilot SITL
To run an ArduPilot simulation with Gazebo, the frame should have gazebo-
in it and have JSON as model. Other commandline parameters are the same
as usual on SITL.
To see the effect of the speed-up set the param SIM_SPEEDUP to a value
greater than one:
MANUAL> param set SIM_SPEEDUP 10
3. Streaming camera video
Images from camera sensors may be streamed with GStreamer using
the GstCameraPlugin sensor plugin. The example gimbal models include the
plugin element:
Video is encoded in H.264 with nvh264enc when <use_cuda> is true.
Otherwise, when <use_vaapi> is true (the default), the plugin uses the
VA-API hardware encoder vah264enc (Intel and AMD GPUs, from
gstreamer1.0-plugins-bad with a VA driver such as mesa-va-drivers or
intel-media-va-driver) when one is available, and falls back to the software
encoder x264enc from gstreamer1.0-plugins-ugly.
The <image_topic> and <enable_topic> parameters are deduced from the
topic name for the camera sensor, but may be overriden if required.
The gimbal.sdf world includes a 3 degrees of freedom gimbal with a
zoomable camera. To start streaming:
In addition to the Iris and Zephyr models included here, a selection
of models configured use the ArduPilot Gazebo plugin is available in
ArduPilot/SITL_Models.
Click on the images to see further details.
Development
The checks run in CI can be run locally with pre-commit:
pipx install pre-commit
pre-commit install # run the checks on every commit
pre-commit run --all-files # run all checks now
The cppcheck and check-sdf hooks need cppcheck and Gazebo installed,
skip them with SKIP=cppcheck,check-sdf otherwise. The SDF files can also be
checked directly with scripts/check_sdf.sh [file.sdf ...].
Troubleshooting
For issues concerning installing and running Gazebo on your platform please
consult the Gazebo documentation for troubleshooting frequent issues.
Does ArduPilot/ardupilot_gazebo have a project website?
No homepage URL was recorded for ArduPilot/ardupilot_gazebo in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How many stars does ArduPilot/ardupilot_gazebo have?
ArduPilot/ardupilot_gazebo has 240 GitHub stars — refresh the page for the live number, or check github.com/ArduPilot/ardupilot_gazebo. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is ArduPilot/ardupilot_gazebo open source?
Yes — ArduPilot/ardupilot_gazebo ships under the LGPL-3.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/ArduPilot/ardupilot_gazebo.
What is ArduPilot/ardupilot_gazebo?
ArduPilot/ardupilot_gazebo (ArduPilot/ardupilot_gazebo) is a C++ project on GitHub. From the project's own README: Plugins and models for vehicle simulation in Gazebo Sim with ArduPilot SITL controllers
Where do I read more about ArduPilot/ardupilot_gazebo?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/ArduPilot/ardupilot_gazebo is the definitive source.
Read full README in the tab above.
Is ardupilot_gazebo worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of ardupilot_gazebo.