Install RL on Ubuntu
For Ubuntu, we maintain a personal package archive (PPA) on Launchpad. It contains the currently released version of the Robotics Library and, most importantly, all dependencies necessary for that version. The main advantages of the PPA are that the installation of RL cleanly works together with your package manager, resolves all dependencies and provides automatic updates.
Currently, the oldest supported Ubuntu version is 12.04 LTS Precise. However, future versions of RL will probably only support newer versions, roughly following Ubuntu's support periods. The Ubuntu PPA can usually also be used for other Debian-based systems.
The only limitation of the Ubuntu packages is that we purposely left out some rarely used hardware interfaces (Comedi, ATIDAQ, and FireWire cameras), and optional collision detection libraries. This is just a compromise between the number of dependencies and functionality required by most users.
Package Installation on Ubuntu
To add the Robotics Library repository to your system, execute the following commands in your terminal.
sudo apt-add-repository ppa:roblib/ppa
sudo apt-get update
You can then install RL's runtime files, some demo applications and example models with a terminal command or by using your favorite package manager, e.g., the Ubuntu Software Center, Synaptic, or similar applications.
sudo apt-get install librl librl-demos librl-examples
If you want to develop software using the Robotics Library, you should install the development files.
sudo apt-get install librl-dev
Additional packages including extra applications, API documentation, and debug symbols are available as well.
sudo apt-get install librl-extras librl-doc librl-dbg
Installation for other Debian-based systems
Even though we have not tested other Debian-based systems, it is worth trying to add the PPA and proceeding as described above.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 01172DC4
sudo echo "deb https://ppa.launchpadcontent.net/roblib/ppa/ubuntu xenial main" >> /etc/apt/sources.list
sudo apt-get update
sudo apt-get install librl
The label xenial will give you the package versions made for Ubuntu 16.04 and should be replaced appropriately. If you think your system is much older or newer, you should try other available versions.
Trying out RL
The demo applications can be run directly from the start menu (look for Robotics Library under the categories Science and Robotics) or via one of the following terminal commands.
The first demo uses the scene graph component to visualize a simple scene with a Unimation Puma 560 robot manipulator.
You can then try a collision detection and distance computation demo with a basic scene consisting of two boxes.
The next two applications combine kinematics and visualization for the control of a Unimation Puma 560 robot manipulator.
/usr/bin/rlCoachKin /usr/share/rl-0.7.0/examples/rlsg/unimation-puma560_boxes.xml /usr/share/rl-0.7.0/examples/rlkin/unimation-puma560.xml
/usr/bin/rlCoachMdl /usr/share/rl-0.7.0/examples/rlsg/unimation-puma560_boxes.xml /usr/share/rl-0.7.0/examples/rlmdl/unimation-puma560.xml
Finally, you can use the path planning demo application to find collision free motions for the Unimation Puma 560 using the Rapidly-Exploring Random Trees (RRT) algorithm.
Continue with the tutorial First Steps with RL on Linux to learn how to develop with RL.