Rigid Body Dynamics Library
Mainpage
rbdl_logo.png

This is the documentation of RBDL, the Rigid Body Dynamics Library. The library contains highly efficient code for both forward and inverse dynamics for kinematic chains and branched models. It includes:

  • Recursive Newton Euler Algorithm (RNEA)
  • Composite Rigid Body Algorithm (CRBA)
  • Articulated Body Algorithm (ABA).

Furthermore it contains code for forward and inverse kinematics, computations of Jacobians, contact handling. Models can be loaded from Lua scripts or URDF files.

The code is developed by Martin Felis martin.felis@iwr.uni-heidelberg.de at the research group Optimization in Robotics and Biomechanics (ORB) of the Interdisciplinary Center for Scientific Computing (IWR) at Heidelberg University. The code is heavily inspired by the pseudo code of the book "Rigid Body Dynamics Algorithms" of Roy Featherstone.

The code has no external dependencies but for optimal performance it is advised to use version 3 of the Eigen math library. More information about it can be found here: http://eigen.tuxfamily.org/. The Eigen3 library must be obtained and installed separately.

Download

You can download the most recent stable version as zip file from here:
https://bitbucket.org/rbdl/rbdl/get/default.zip

All development takes place on Bitbucket and you can follow RBDL's development here:
https://bitbucket.org/rbdl/rbdl

Recent Changes

  • 28 April 2016: New release 2.5.0:
    • Added an experimental Cython based Python wrapper of RBDL. The API is very close to the C++ API. For a brief glimpse of the API see Python Example
    • Matthew Millard added CustomJoints which allow to create different joint types completely by user code. They are implemented as proxy joints for which their behaviour is specified using virtual functions.
    • Added CalcMInvTimesTau() that evaluates multiplication of the inverse of the joint space inertia matrix with a vector in O(n) time.
    • Added JointTypeFloatingBase which uses TX,TY,TZ and a spherical joint for the floating base joint.
    • Loading of floating base URDF models must now be specified as a third parameter to URDFReadFromFile() and URDFReadFromString()
    • Added the URDF code from Bullet3 which gets used when ROS is not found. Otherwise use the URDF libraries found via Catkin.
    • Added CalcPointVelocity6D, CalcPointAcceleration6D, and CalcPointJacobian6D that compute both linear and angular quantities
    • Removed Model::SetFloatingBase (body). Use a 6-DoF joint or JointTypeFloatingBase instead.
    • Fixed building issues when building DLL with MSVC++.
  • 20 March 2016: New bugfix version 2.4.1:
    • critical: fixed termination criterion for InverseKinematics(). The termination criterion would be evaluated too early and thus report convergence too early. This was reported independently by Kevin Stein, Yun Fei, and Davide Corradi. Thanks for the reports!
    • critical: fixed CompositeRigidBodyAlgorithm() when using spherical joints (thanks to Sébastien Barthélémy for reporting!)
  • 23 February 2015: New version 2.4.0:

See API Changes for a complete version history.

Examples

A simple example for creation of a model and computation of the forward dynamics using the C++ API can be found here.

Another example that uses the LuaModel Addon can be found here.

An example of the Python wrapper can be found at Python Example.

API reference separated by functional modules

The page API Changes contains information about incompatibilities of the existing versions and how to migrate.

Licensing

The library is published under the very permissive zlib free software license which should allow you to use the software wherever you need. Here is the full license text:

RBDL - Rigid Body Dynamics Library
Copyright (c) 2011-2014 Martin Felis <martin.felis@iwr.uni-heidelberg.de>

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

   1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.

   2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.

   3. This notice may not be removed or altered from any source
   distribution.

Acknowledgements

Work on this library was funded by the Heidelberg Graduate School of Mathematical and Computational Methods for the Sciences (HGS) and the European FP7 projects ECHORD (grant number 231143) and Koroibot (grant number 611909).