## CategoryStack <> <> == Overview == gazebo_ros_pkgs is a set of ROS packages that provide the necessary interfaces to simulate a robot in the [[http://gazebosim.org|Gazebo]] 3D rigid body simulator for robots. It integrates with ROS using ROS messages, services and dynamic reconfigure. {{{#!wiki version melodic_and_newer <> }}} {{{#!wiki version lunar_and_lower <> }}} Some of the features of gazebo_ros_pkgs include: * Leverage existing standard ROS plugins for Gazebo * Improves out of the box support for controllers using ros_control * Many [[https://github.com/ros-simulation/gazebo_ros_pkgs/blob/melodic-devel/SENSORS.md|simulated sensors]] available and ready to work == Gazebo Simulator supported version == The major version (i.e 7.x series of gazebo7 for ROS Kinetic/Lunar) of gazebo present in ROS is selected at the beginning of the ROS release cycle and will be kept (due to binary compatibility reasons) during the whole life of the ROS distribution. }}} {{{#!wiki version indigo ROS Indigo is using the '''gazebo-2.x''' series }}} {{{#!wiki version jade ROS Jade is using the '''gazebo-5.x''' series Some of the new features of Gazebo5 are: * [[http://gazebosim.org/blog/feature_physics|Multiple physics engine support]] * [[http://gazebosim.org/tutorials?tut=clone_simulation&cat=physics|Clone running simulations]] * [[http://gazebosim.org/blog/feature_dem|Digital Elevation Models]] * [[http://gazebosim.org/blog/feature_unified_tool|Unified command-line tool (gz)]] * [[http://gazebosim.org/tutorials?cat=gazebojs|Javascript interface]] * Oculus Rift and Razer Hydra support * C++11 Integration A list of all the changes are available at the [[https://bitbucket.org/osrf/gazebo/src/gazebo5/Changelog.md?at=gazebo5|Gazebo 5.x changelog file]]. }}} {{{#!wiki version kinetic * [[http://gazebosim.org/tutorials?tut=model_editor&cat=build_robot|Improved graphical model editor]] * [[http://gazebosim.org/tutorials?tut=torsional_friction&cat=physics|Torsional friction]] * Wide angle camera sensor * Simulation models composed of other models * Improved log playback speed and graphical interface * New GUI tools including alignment functionality and undo A list of all the changes are available at the [[https://bitbucket.org/osrf/gazebo/src/gazebo7/Changelog.md?at=gazebo7|Gazebo 7.x changelog file]]. }}} {{{#!wiki version melodic_and_newer ROS Melodic is using the '''gazebo-9.x''' series Some of the new features of Gazebo9 are: * [[http://gazebosim.org/tutorials?tut=model_editor&cat=build_robot|Improved graphical model editor]] * [[http://gazebosim.org/blog/car_sim|Vehicle and city simulation]] * [[https://www.youtube.com/watch?v=G5qBaEXpkvE|Plotting Utility]] * [[https://www.youtube.com/watch?v=egWAMbU7f6Y|Visual markers]] * Generalization of Actor animations * [[http://gazebosim.org/tutorials?tut=parallel&cat=physics|Parallel physics (threaded islands in ODE)]] * [[http://gazebosim.org/tutorials?tut=model_editor&cat=build_robot|Improved graphical model editor]] A list of all the changes are available at the [[https://bitbucket.org/osrf/gazebo/src/gazebo9/Changelog.md?at=gazebo9|Gazebo 9.x changelog file]]. }}} == Migrating from previous ROS releases == Migrating from a previous version of ROS could require to adapt code in two different aspects: * '''Migrate Gazebo upstream code''': since every version of ROS brings a new major version of Gazebo, some changes could be need to adapt Gazebo third party code, mostly plugins. Please read the [[https://bitbucket.org/osrf/gazebo/src/default/Migration.md?at=default|Gazebo migration document]] for this purpose. {{{#!wiki version hydro * '''Migrate gazebo_ros_pkgs ROS related code''': some ROS specific code could need to be upgraded when upgrading. The instructions are well covered in the [[hydro/Migration#Gazebo|Hydro Migration document]] }}} {{{#!wiki version indigo * '''Migrate gazebo_ros_pkgs ROS related code''': some ROS specific code could need to be upgraded when upgrading to Indigo. There are no specific instructions on this area. }}} {{{#!wiki version jade * '''Migrate gazebo_ros_pkgs ROS related code''': some ROS specific code could need to be upgraded when upgrading. The instructions are well covered in the [[jade/Migration#Gazebo_Simulator|Jade Migration document]] }}} {{{#!wiki version kinetic * '''Migrate gazebo_ros_pkgs ROS related code''': some ROS specific code could need to be upgraded when upgrading. The instructions are well covered in the [[jade/Migration#Gazebo_Simulator|Kinetic Migration document]] }}} {{{#!wiki version lunar * '''Migrate gazebo_ros_pkgs ROS related code''': the gazebo version used in Lunar is the same than in Kinetic and the Lunar code starts from a copy of Kinetic code so the code from Kinetic should be compatible with Lunar. }}} {{{#!wiki version melodic * '''Migrate gazebo_ros_pkgs ROS related code''': there are some [[https://github.com/ros-simulation/gazebo_ros_pkgs/issues/725|disruptive changes]] in Melodic with respect to the gazebo_ros_pkgs version present in Lunar. Please proceed according. }}} == Documentation and Support == === Documentation === * Tutorials related to [[http://gazebosim.org/tutorials?cat=connect_ros|connect to Gazebo with ROS]] * Tutorials related to [[http://gazebosim.org/tutorials?cat=get_started|get started with the Gazebo Simulator]] * Tutorials related to [[http://gazebosim.org/tutorials?cat=write_plugin|how to write a plugin for the Gazebo simulator (non ROS code)]] === Support === * [[http://answers.gazebosim.org/questions/|Support site for user questions]] * [[https://groups.google.com/a/osrfoundation.org/d/forum/gazebo|Gazebo mailing list]] * [[https://bitbucket.org/osrf/gazebo/issues?status=new&status=open|Gazebo Simulator issue tracker]] == Gazebo/ROS robot simulations ready to use == Different robots provide Gazebo Simulation support out of the box. Among others: * [[Robots/Robonaut2|Robonaut2 (NASA)]] * [[http://gazebosim.org/tutorials?tut=drcsim_create_atlas_world&cat=drcsim|Atlas Robot (Boston Dynamics)]] * [[http://docs.fetchrobotics.com/gazebo.html|Freight (by Fetch Robotics)]] * [[https://github.com/RethinkRobotics/baxter_simulator|Baxter (by Rethink Robotics)]] * [[http://emanual.robotis.com/docs/en/platform/turtlebot3/simulation/#gazebo-3d|TurtleBot3 (Robotis)]] * [[https://blog.pal-robotics.com/new-ros-tutorials-to-simulate-with-tiago-easily/|Tiago (Pal Robotics)]] * [[pr2_simulator|PR2 (Willow Garage)]] * [[husky_ur5_moveit_config|Husky UR5 Robot (ClearPath Robotics)]] * [[cob_simulation|Care-O-Bot Robot]] * [[kobuki_gazebo|Kobuki Robot (Yujin Robotics)]] * [[https://github.com/ros-naoqi/nao_virtual/blob/master/nao_gazebo_plugin/README.rst|Nao Humanoid (Aldebaraan)]] * [[http://docs.ros.org/api/jackal_tutorials/html/simulation.html|Jackal Robot]] * [[ur_gazebo|Universal UR5/10 robot arms]] * [[hector_quadrotor|UAV simulation -Hector]] * [[http://docs.erlerobotics.com/erle_robots/erle_copter/gazebo_simulation|Erle Copter (Erle Robotics)]]