Skip to content
A fast and flexible implementation of Rigid Body Dynamics algorithms and their analytical derivatives
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis @ 083fa2c travis: sync submodule Oct 29, 2018
benchmark [benchmark] Jacobian benchmark Feb 27, 2019
bindings bindings/python: remove useless warning Feb 27, 2019
cmake @ cea261e cmake: sync submodule Feb 27, 2019
doc Inverse kinematics worked example Jan 24, 2019
examples [python][robot_wrapper] Add transparency support for Meshcat viewer. Feb 25, 2019
models models: remove previous license Feb 20, 2019
src algo/cholesky: remove useless PINOCCHIO_UNUSED_VARIABLE Feb 27, 2019
travis_custom
unittest [frames] frameVelocity and frameAcceleration return value in C++ Feb 27, 2019
utils
.ci-deps [CI] work with hpp-fcl v1, which is not yet in the binary repository Feb 27, 2019
.coveragerc
.gitignore [Git] Update .gitignore Jul 7, 2016
.gitlab-ci.yml
.gitmodules modules: use https instead relative path Feb 18, 2019
.travis.yml
CMakeLists.txt
COPYING.LESSER copyright: we are now in 2019 Jan 9, 2019
README.md

README.md

Pinocchio: a C++ library for efficient Rigid Multi-body Dynamics computations

License Build Status Coverage report

Pinocchio instantiates the state-of-the-art Rigid Body Algorithms for poly-articulated systems based on revisited Roy Featherstone's algorithms. Besides, Pinocchio provides the analytical derivatives of the main Rigid-Body Algorithms like the Recursive Newton-Euler Algorithm or the Articulated-Body Algorithm.

Pinocchio is first tailored for robotics applications, but it can be used in extra contexts (biomechanics, computer graphics, vision, etc.). It is built upon Eigen for linear algebra and FCL for collision detection. Pinocchio comes with a Python interface for fast code prototyping.

Pinocchio is now at the heart of various robotics softwares as the Stack-of-Tasks or the Humanoid Path Planner.

If you want to learn more on Pinocchio internal behaviors and main features, we invite you to read the related paper.

Pinocchio features

Pinocchio is fast:

  • C++ template library,
  • cache friendly,
  • automatic code generation support.

Pinocchio implements rigid body dynamics algorithms:

  • forward kinematics and its analytical derivatives,
  • forward/inverse dynamics and their analytical derivatives,
  • centroidal dynamics and its analytical derivatives.

Pinocchio is flexible:

  • header only,
  • C++11 compliant.

Pinocchio is multi-thread friendly.
Pinocchio is reliable and extensively tested (unit-tests, simulations and real robotics applications).
Pinocchio is supported on Mac Os X and many Linux distributions (See build status here).

Ongoing developments

If you want to follow the current developments, you can directly refer to the devel branch.

Installation

Pinocchio can be easily installed on various Linux (Ubuntu, Fedora, etc.) and Unix distributions (Mac OS X, BSD, etc.). Please refer to the installation procedure.

Pinocchio is also being deployed on ROS, you may follow its deployment status on Melodic or Kinetic.

Examples

We provide some basic examples on how to use Pinocchio in Python in the examples/python directory.

Tutorials

Pinocchio is coming with a large bunch of tutorials aiming at introducing the basic tools for robotics control. The content of the tutorials are described here and the source code of these tutorials is located here.

Citing Pinocchio

To cite Pinocchio in your academic research, please use the following bibtex lines:

@misc{pinocchioweb,
   author = {Justin Carpentier and Florian Valenza and Nicolas Mansard and others},
   title = {Pinocchio: fast forward and inverse dynamics for poly-articulated systems},
   howpublished = {https://stack-of-tasks.github.io/pinocchio},
   year = {2015--2019}
}

and the following one for the reference to the paper introducing Pinocchio:

@inproceedings{carpentier2019pinocchio,
   title={The Pinocchio C++ library -- A fast and flexible implementation of rigid body dynamics algorithms and their analytical derivatives},
   author={Carpentier, Justin and Saurel, Guilhem and Buondonno, Gabriele and Mirabel, Joseph and Lamiraux, Florent and Stasse, Olivier and Mansard, Nicolas},
   booktitle={IEEE International Symposium on System Integrations (SII)},
   year={2019}
}

The algorithms for the analytical derivatives of rigid-body dynamics algorithms are detailed here:

@inproceedings{carpentier2018analytical,
  title = {Analytical Derivatives of Rigid Body Dynamics Algorithms},
  author = {Carpentier, Justin and Mansard, Nicolas},
  booktitle = {Robotics: Science and Systems},
  year = {2018}
}

Questions and Issues

You have a question or an issue? You may either directly open a new issue or use the mailing list pinocchio@laas.fr.

Credits

The following people have been involved in the development of Pinocchio:

If you have taken part to the development of Pinocchio, feel free to add your name and contribution here.

Acknowledgments

The development of Pinocchio is supported by the Gepetto team @LAAS-CNRS and the Willow team @INRIA.

You can’t perform that action at this time.