Introduction
------------

This documentation explains how to use `ROS <https://www.ros.org/>`__
with `Robotran <https://www.robotran.be/>`__. It is currently supported
only for C and Linux environment.

For a detailed understanding of the ROSBOTRAN functioning, please refer
to this `master thesis <http://hdl.handle.net/2078.1/thesis:25226>`__
(in French)

This tutorial explains how to use Robotran within ROS by connecting a
`Raspberry <https://www.raspberrypi.org/>`__ with you personal computer
and run ROS nodes across multiple machines. One of the nodes will be the
Robotran C-executable.

.. figure:: figure/ROSbotran.png
   :alt: ROSbotran

   ROSbotran
See also this Youtube video `Real-time car simulation with
ROSbotran <https://youtu.be/8QmK3qCu-es>`__.

    NOTE:

    This tutorial is dedicated for
    `ROS1 <http://wiki.ros.org/ROS/Installation>`__. For instruction
    with `ROS2 <https://docs.ros.org/>`__, see `here <./ROS2.html>`__.

..

    If you have a problem, please contact us:

    | Contact:
    | ``info@robotran.be``
    | `robotran.be <https://www.robotran.be/>`__

Contents
~~~~~~~~