ros_gz repository

Repository Summary

Checkout URI https://github.com/gazebosim/ros_gz.git
VCS Type git
VCS Version humble
Last Updated 2024-07-09
Dev Status MAINTAINED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
ros_gz 0.244.15
ros_gz_bridge 0.244.15
ros_gz_image 0.244.15
ros_gz_interfaces 0.244.15
ros_gz_point_cloud 0.7.0
ros_gz_sim 0.244.15
ros_gz_sim_demos 0.244.15
ros_ign 0.244.15
ros_ign_bridge 0.244.15
ros_ign_gazebo 0.244.15
ros_ign_gazebo_demos 0.244.15
ros_ign_image 0.244.15
ros_ign_interfaces 0.244.15
test_ros_gz_bridge 0.244.15

README

Build Status

ROS 2 version Gazebo version Branch Binaries hosted at
Foxy Citadel foxy https://packages.ros.org
Foxy Edifice foxy only from source
Galactic Edifice galactic https://packages.ros.org
Galactic Fortress galactic only from source
Humble Fortress humble https://packages.ros.org
Humble Garden humble gazebo packages[^1]
Humble Harmonic humble gazebo packages[^1]
Rolling Edifice ros2 only from source
Rolling Fortress ros2 https://packages.ros.org
Rolling Garden ros2 only from source
Rolling Harmonic ros2 only from source

[^1]: Binaries for these pairings are provided from a the packages.osrfoundation.org repository. Refer to https://gazebosim.org/docs/latest/ros_installation for installation instructions.

For information on ROS 2 and Gazebo compatibility, refer to the melodic branch README

Please ticket an issue if you'd like support to be added for some combination.

Details about the renaming process from ign to gz .

Note: The ros_ign prefixed packages are shim packages that redirect to their ros_gz counterpart. Under most circumstances you want to be using the ros_gz counterpart.

Integration between ROS and Gazebo

Packages

This repository holds packages that provide integration between ROS and Gazebo:

Install

This branch supports ROS Humble. See above for other ROS versions.

Binaries

Humble binaries are available for Fortress. They are hosted at https://packages.ros.org.

  1. Add https://packages.ros.org

    sudo sh -c 'echo "deb [arch=$(dpkg --print-architecture)] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/ros2-latest.list'
    curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
    sudo apt-get update
    
  2. Install ros_gz

    sudo apt install ros-humble-ros-gz
    

From source

ROS

Be sure you've installed ROS Humble (at least ROS-Base). More ROS dependencies will be installed below.

Gazebo

Install either Edifice, Fortress, or Garden.

Set the GZ_VERSION environment variable to the Gazebo version you'd like to compile against. For example:

export GZ_VERSION=edifice # IMPORTANT: Replace with correct version

You only need to set this variable when compiling, not when running.

Compile ros_gz

The following steps are for Linux and OSX.

  1. Create a colcon workspace:
    # Setup the workspace
    mkdir -p ~/ws/src
    cd ~/ws/src

    # Download needed software
    git clone https://github.com/gazebosim/ros_gz.git -b humble

  1. Install dependencies (this may also install Gazebo):
    cd ~/ws
    rosdep install -r --from-paths src -i -y --rosdistro humble

> If `rosdep` fails to install Gazebo libraries and you have not installed them before, please follow [Gazebo installation instructions](https://gazebosim.org/docs/latest/install).
  1. Build the workspace:
    # Source ROS distro's setup.bash
    source /opt/ros/<distro>/setup.bash

    # Build and install into workspace
    cd ~/ws
    colcon build

[!TIP] The ros_gz library makes heavy use of templates which causes compilers to consume a lot of memory. If your build fails with c++: fatal error: Killed signal terminated program cc1plus try building with colcon build --parallel-workers=1 --executor sequential. You might also have to set export MAKEFLAGS="-j 1" before running colcon build to limit the number of processors used to build a single package.

If `colcon build` fails with [this issue](https://github.com/gazebosim/ros_gz/issues/401)
    CMake Error at CMakeLists.txt:81 (find_package):
      By not providing "Findactuator_msgs.cmake" in CMAKE_MODULE_PATH this
      project has asked CMake to find a package configuration file provided by
      "actuator_msgs", but CMake did not find one.

    cd src
    git clone git@github.com:rudislabs/actuator_msgs.git
    cd ../
    colcon build

ROSCon 2022

Project Template

A template project integrating ROS and Gazebo simulator

CONTRIBUTING

Any contribution that you make to this repository will be under the Apache 2 License, as dictated by that license:

5. Submission of Contributions. Unless You explicitly state otherwise,
   any Contribution intentionally submitted for inclusion in the Work
   by You to the Licensor shall be under the terms and conditions of
   this License, without any additional terms or conditions.
   Notwithstanding the above, nothing herein shall supersede or modify
   the terms of any separate license agreement you may have executed
   with Licensor regarding such Contributions.

Repository Summary

Checkout URI https://github.com/gazebosim/ros_gz.git
VCS Type git
VCS Version humble
Last Updated 2024-07-09
Dev Status MAINTAINED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
ros_gz 0.244.15
ros_gz_bridge 0.244.15
ros_gz_image 0.244.15
ros_gz_interfaces 0.244.15
ros_gz_point_cloud 0.7.0
ros_gz_sim 0.244.15
ros_gz_sim_demos 0.244.15
ros_ign 0.244.15
ros_ign_bridge 0.244.15
ros_ign_gazebo 0.244.15
ros_ign_gazebo_demos 0.244.15
ros_ign_image 0.244.15
ros_ign_interfaces 0.244.15
test_ros_gz_bridge 0.244.15

README

Build Status

ROS 2 version Gazebo version Branch Binaries hosted at
Foxy Citadel foxy https://packages.ros.org
Foxy Edifice foxy only from source
Galactic Edifice galactic https://packages.ros.org
Galactic Fortress galactic only from source
Humble Fortress humble https://packages.ros.org
Humble Garden humble gazebo packages[^1]
Humble Harmonic humble gazebo packages[^1]
Rolling Edifice ros2 only from source
Rolling Fortress ros2 https://packages.ros.org
Rolling Garden ros2 only from source
Rolling Harmonic ros2 only from source

[^1]: Binaries for these pairings are provided from a the packages.osrfoundation.org repository. Refer to https://gazebosim.org/docs/latest/ros_installation for installation instructions.

For information on ROS 2 and Gazebo compatibility, refer to the melodic branch README

Please ticket an issue if you'd like support to be added for some combination.

Details about the renaming process from ign to gz .

Note: The ros_ign prefixed packages are shim packages that redirect to their ros_gz counterpart. Under most circumstances you want to be using the ros_gz counterpart.

Integration between ROS and Gazebo

Packages

This repository holds packages that provide integration between ROS and Gazebo:

Install

This branch supports ROS Humble. See above for other ROS versions.

Binaries

Humble binaries are available for Fortress. They are hosted at https://packages.ros.org.

  1. Add https://packages.ros.org

    sudo sh -c 'echo "deb [arch=$(dpkg --print-architecture)] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/ros2-latest.list'
    curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
    sudo apt-get update
    
  2. Install ros_gz

    sudo apt install ros-humble-ros-gz
    

From source

ROS

Be sure you've installed ROS Humble (at least ROS-Base). More ROS dependencies will be installed below.

Gazebo

Install either Edifice, Fortress, or Garden.

Set the GZ_VERSION environment variable to the Gazebo version you'd like to compile against. For example:

export GZ_VERSION=edifice # IMPORTANT: Replace with correct version

You only need to set this variable when compiling, not when running.

Compile ros_gz

The following steps are for Linux and OSX.

  1. Create a colcon workspace:
    # Setup the workspace
    mkdir -p ~/ws/src
    cd ~/ws/src

    # Download needed software
    git clone https://github.com/gazebosim/ros_gz.git -b humble

  1. Install dependencies (this may also install Gazebo):
    cd ~/ws
    rosdep install -r --from-paths src -i -y --rosdistro humble

> If `rosdep` fails to install Gazebo libraries and you have not installed them before, please follow [Gazebo installation instructions](https://gazebosim.org/docs/latest/install).
  1. Build the workspace:
    # Source ROS distro's setup.bash
    source /opt/ros/<distro>/setup.bash

    # Build and install into workspace
    cd ~/ws
    colcon build

[!TIP] The ros_gz library makes heavy use of templates which causes compilers to consume a lot of memory. If your build fails with c++: fatal error: Killed signal terminated program cc1plus try building with colcon build --parallel-workers=1 --executor sequential. You might also have to set export MAKEFLAGS="-j 1" before running colcon build to limit the number of processors used to build a single package.

If `colcon build` fails with [this issue](https://github.com/gazebosim/ros_gz/issues/401)
    CMake Error at CMakeLists.txt:81 (find_package):
      By not providing "Findactuator_msgs.cmake" in CMAKE_MODULE_PATH this
      project has asked CMake to find a package configuration file provided by
      "actuator_msgs", but CMake did not find one.

    cd src
    git clone git@github.com:rudislabs/actuator_msgs.git
    cd ../
    colcon build

ROSCon 2022

Project Template

A template project integrating ROS and Gazebo simulator

CONTRIBUTING

Any contribution that you make to this repository will be under the Apache 2 License, as dictated by that license:

5. Submission of Contributions. Unless You explicitly state otherwise,
   any Contribution intentionally submitted for inclusion in the Work
   by You to the Licensor shall be under the terms and conditions of
   this License, without any additional terms or conditions.
   Notwithstanding the above, nothing herein shall supersede or modify
   the terms of any separate license agreement you may have executed
   with Licensor regarding such Contributions.

Repository Summary

Checkout URI https://github.com/gazebosim/ros_gz.git
VCS Type git
VCS Version humble
Last Updated 2024-07-09
Dev Status MAINTAINED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
ros_gz 0.244.15
ros_gz_bridge 0.244.15
ros_gz_image 0.244.15
ros_gz_interfaces 0.244.15
ros_gz_point_cloud 0.7.0
ros_gz_sim 0.244.15
ros_gz_sim_demos 0.244.15
ros_ign 0.244.15
ros_ign_bridge 0.244.15
ros_ign_gazebo 0.244.15
ros_ign_gazebo_demos 0.244.15
ros_ign_image 0.244.15
ros_ign_interfaces 0.244.15
test_ros_gz_bridge 0.244.15

README

Build Status

ROS 2 version Gazebo version Branch Binaries hosted at
Foxy Citadel foxy https://packages.ros.org
Foxy Edifice foxy only from source
Galactic Edifice galactic https://packages.ros.org
Galactic Fortress galactic only from source
Humble Fortress humble https://packages.ros.org
Humble Garden humble gazebo packages[^1]
Humble Harmonic humble gazebo packages[^1]
Rolling Edifice ros2 only from source
Rolling Fortress ros2 https://packages.ros.org
Rolling Garden ros2 only from source
Rolling Harmonic ros2 only from source

[^1]: Binaries for these pairings are provided from a the packages.osrfoundation.org repository. Refer to https://gazebosim.org/docs/latest/ros_installation for installation instructions.

For information on ROS 2 and Gazebo compatibility, refer to the melodic branch README

Please ticket an issue if you'd like support to be added for some combination.

Details about the renaming process from ign to gz .

Note: The ros_ign prefixed packages are shim packages that redirect to their ros_gz counterpart. Under most circumstances you want to be using the ros_gz counterpart.

Integration between ROS and Gazebo

Packages

This repository holds packages that provide integration between ROS and Gazebo:

Install

This branch supports ROS Humble. See above for other ROS versions.

Binaries

Humble binaries are available for Fortress. They are hosted at https://packages.ros.org.

  1. Add https://packages.ros.org

    sudo sh -c 'echo "deb [arch=$(dpkg --print-architecture)] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/ros2-latest.list'
    curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
    sudo apt-get update
    
  2. Install ros_gz

    sudo apt install ros-humble-ros-gz
    

From source

ROS

Be sure you've installed ROS Humble (at least ROS-Base). More ROS dependencies will be installed below.

Gazebo

Install either Edifice, Fortress, or Garden.

Set the GZ_VERSION environment variable to the Gazebo version you'd like to compile against. For example:

export GZ_VERSION=edifice # IMPORTANT: Replace with correct version

You only need to set this variable when compiling, not when running.

Compile ros_gz

The following steps are for Linux and OSX.

  1. Create a colcon workspace:
    # Setup the workspace
    mkdir -p ~/ws/src
    cd ~/ws/src

    # Download needed software
    git clone https://github.com/gazebosim/ros_gz.git -b humble

  1. Install dependencies (this may also install Gazebo):
    cd ~/ws
    rosdep install -r --from-paths src -i -y --rosdistro humble

> If `rosdep` fails to install Gazebo libraries and you have not installed them before, please follow [Gazebo installation instructions](https://gazebosim.org/docs/latest/install).
  1. Build the workspace:
    # Source ROS distro's setup.bash
    source /opt/ros/<distro>/setup.bash

    # Build and install into workspace
    cd ~/ws
    colcon build

[!TIP] The ros_gz library makes heavy use of templates which causes compilers to consume a lot of memory. If your build fails with c++: fatal error: Killed signal terminated program cc1plus try building with colcon build --parallel-workers=1 --executor sequential. You might also have to set export MAKEFLAGS="-j 1" before running colcon build to limit the number of processors used to build a single package.

If `colcon build` fails with [this issue](https://github.com/gazebosim/ros_gz/issues/401)
    CMake Error at CMakeLists.txt:81 (find_package):
      By not providing "Findactuator_msgs.cmake" in CMAKE_MODULE_PATH this
      project has asked CMake to find a package configuration file provided by
      "actuator_msgs", but CMake did not find one.

    cd src
    git clone git@github.com:rudislabs/actuator_msgs.git
    cd ../
    colcon build

ROSCon 2022

Project Template

A template project integrating ROS and Gazebo simulator

CONTRIBUTING

Any contribution that you make to this repository will be under the Apache 2 License, as dictated by that license:

5. Submission of Contributions. Unless You explicitly state otherwise,
   any Contribution intentionally submitted for inclusion in the Work
   by You to the Licensor shall be under the terms and conditions of
   this License, without any additional terms or conditions.
   Notwithstanding the above, nothing herein shall supersede or modify
   the terms of any separate license agreement you may have executed
   with Licensor regarding such Contributions.

Repository Summary

Checkout URI https://github.com/gazebosim/ros_gz.git
VCS Type git
VCS Version humble
Last Updated 2024-07-09
Dev Status MAINTAINED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
ros_gz 0.244.15
ros_gz_bridge 0.244.15
ros_gz_image 0.244.15
ros_gz_interfaces 0.244.15
ros_gz_point_cloud 0.7.0
ros_gz_sim 0.244.15
ros_gz_sim_demos 0.244.15
ros_ign 0.244.15
ros_ign_bridge 0.244.15
ros_ign_gazebo 0.244.15
ros_ign_gazebo_demos 0.244.15
ros_ign_image 0.244.15
ros_ign_interfaces 0.244.15
test_ros_gz_bridge 0.244.15

README

Build Status

ROS 2 version Gazebo version Branch Binaries hosted at
Foxy Citadel foxy https://packages.ros.org
Foxy Edifice foxy only from source
Galactic Edifice galactic https://packages.ros.org
Galactic Fortress galactic only from source
Humble Fortress humble https://packages.ros.org
Humble Garden humble gazebo packages[^1]
Humble Harmonic humble gazebo packages[^1]
Rolling Edifice ros2 only from source
Rolling Fortress ros2 https://packages.ros.org
Rolling Garden ros2 only from source
Rolling Harmonic ros2 only from source

[^1]: Binaries for these pairings are provided from a the packages.osrfoundation.org repository. Refer to https://gazebosim.org/docs/latest/ros_installation for installation instructions.

For information on ROS 2 and Gazebo compatibility, refer to the melodic branch README

Please ticket an issue if you'd like support to be added for some combination.

Details about the renaming process from ign to gz .

Note: The ros_ign prefixed packages are shim packages that redirect to their ros_gz counterpart. Under most circumstances you want to be using the ros_gz counterpart.

Integration between ROS and Gazebo

Packages

This repository holds packages that provide integration between ROS and Gazebo:

Install

This branch supports ROS Humble. See above for other ROS versions.

Binaries

Humble binaries are available for Fortress. They are hosted at https://packages.ros.org.

  1. Add https://packages.ros.org

    sudo sh -c 'echo "deb [arch=$(dpkg --print-architecture)] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/ros2-latest.list'
    curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
    sudo apt-get update
    
  2. Install ros_gz

    sudo apt install ros-humble-ros-gz
    

From source

ROS

Be sure you've installed ROS Humble (at least ROS-Base). More ROS dependencies will be installed below.

Gazebo

Install either Edifice, Fortress, or Garden.

Set the GZ_VERSION environment variable to the Gazebo version you'd like to compile against. For example:

export GZ_VERSION=edifice # IMPORTANT: Replace with correct version

You only need to set this variable when compiling, not when running.

Compile ros_gz

The following steps are for Linux and OSX.

  1. Create a colcon workspace:
    # Setup the workspace
    mkdir -p ~/ws/src
    cd ~/ws/src

    # Download needed software
    git clone https://github.com/gazebosim/ros_gz.git -b humble

  1. Install dependencies (this may also install Gazebo):
    cd ~/ws
    rosdep install -r --from-paths src -i -y --rosdistro humble

> If `rosdep` fails to install Gazebo libraries and you have not installed them before, please follow [Gazebo installation instructions](https://gazebosim.org/docs/latest/install).
  1. Build the workspace:
    # Source ROS distro's setup.bash
    source /opt/ros/<distro>/setup.bash

    # Build and install into workspace
    cd ~/ws
    colcon build

[!TIP] The ros_gz library makes heavy use of templates which causes compilers to consume a lot of memory. If your build fails with c++: fatal error: Killed signal terminated program cc1plus try building with colcon build --parallel-workers=1 --executor sequential. You might also have to set export MAKEFLAGS="-j 1" before running colcon build to limit the number of processors used to build a single package.

If `colcon build` fails with [this issue](https://github.com/gazebosim/ros_gz/issues/401)
    CMake Error at CMakeLists.txt:81 (find_package):
      By not providing "Findactuator_msgs.cmake" in CMAKE_MODULE_PATH this
      project has asked CMake to find a package configuration file provided by
      "actuator_msgs", but CMake did not find one.

    cd src
    git clone git@github.com:rudislabs/actuator_msgs.git
    cd ../
    colcon build

ROSCon 2022

Project Template

A template project integrating ROS and Gazebo simulator

CONTRIBUTING

Any contribution that you make to this repository will be under the Apache 2 License, as dictated by that license:

5. Submission of Contributions. Unless You explicitly state otherwise,
   any Contribution intentionally submitted for inclusion in the Work
   by You to the Licensor shall be under the terms and conditions of
   this License, without any additional terms or conditions.
   Notwithstanding the above, nothing herein shall supersede or modify
   the terms of any separate license agreement you may have executed
   with Licensor regarding such Contributions.