Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 37 additions & 4 deletions ur_simulation_gz/doc/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,44 @@
Installation
============

Skip any of below steps is not applicable.
You can install the Universal Robots ROS2 GZ Simulation package in two ways:

1. **From binary packages**: This is the recommended way for most users, as it is quick and easy.
2. **From source**: This is useful if you want to modify the code or if you require to have a
version that is newer than the latest binary package available.

Installation from binary packages
---------------------------------

1. `Install ROS2 <https://docs.ros.org/en/rolling/Installation/Ubuntu-Install-Debians.html>`_
2. Install the package using

.. code-block:: bash

sudo apt-get install ros-${ROS_DISTRO}-ur-simulation-gz

That's it! You can now use the Universal Robots ROS2 GZ Simulation package in your ROS 2
environment. See the :ref:`ur_simulation_gz_usage` section for how to use it.


Installation from source
------------------------

.. note::
This section is only required if you want to build the package from source. Please do that
only, if that's required for you. Reasons why you would need to build it from source are:

- You built one of multiple of this package's dependencies from source and want to use it with
this package.
- You want to develop this package or contribute to it. If you only want to modify the launch
files to fit your application, a better approeach would be to create your own package with
your own launch files that include the ones from this package.

To rather install the binary packages, please refer to the `Installation from binary
packages`_ section above.

Setup ROS2 Workspace
--------------------
~~~~~~~~~~~~~~~~~~~~

1. Create a colcon workspace:

Expand All @@ -30,11 +64,10 @@ Setup ROS2 Workspace

$ cd $COLCON_WS
$ git clone -b ros2 https://github.com/UniversalRobots/Universal_Robots_ROS2_GZ_Simulation.git src/ur_simulation_gz
$ vcs import --input src/ur_simulation_gz/ur_simulation_gz-not-released.rolling.repos src # only required for rolling
$ rosdep update && rosdep install --ignore-src --from-paths src -y

Configure and build Workspace
-----------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To configure and build the workspace execute following commands:

Expand Down
2 changes: 2 additions & 0 deletions ur_simulation_gz/doc/usage.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
:github_url: https://github.com/UniversalRobots/Universal_Robots_ROS2_GZ_Simulation/blob/ros2/ur_simulation_gz/doc/usage.rst

.. _ur_simulation_gz_usage:

Usage
=====

Expand Down
Loading