Skip to main content

An extension of the Flexible Collision Library

Project description

HPP-FCL — An extension of the Flexible Collision Library

Pipeline status Documentation Coverage report Conda Downloads Conda Version PyPI version black ruff

FCL was forked in 2015. Since then, a large part of the code has been rewritten or removed (for the unused and untested part). The broadphase was reintroduced by J. Carpentier in 2022 based on the FCL version 0.7.0.

New features

Compared to the original FCL library, the main new features are:

  • a dedicated and efficient implementation of the GJK algorithm (we do not rely anymore on libccd)
  • the support of safety margins for collision detection
  • an accelerated version of Collision Detection à la Nesterov which leads to increased performances (up to a factor 2). More details are available in this paper
  • the computation of a lower bound of the distance between two objects when collision checking is performed and no collision is found
  • the implementation of Python bindings for easy code prototyping
  • the support of height fields, capsule shapes, etc.
  • the fix of various bugs

This project is now used in many robotics frameworks such as Pinocchio, an open-source software which implements efficient and versatile rigid body dynamics algorithms and the Humanoid Path Planner, an open-source software for Motion and Manipulation Planning.

Performances

Unlike the original FCL library, HPP-FCL implements the well-established GJK algorithm and its variants for collision detection and distance computation. These implementations lead to state-of-the-art performances, as depicted by the figure below. In particular, you can observe that GJK-based approaches largely outperform solutions based on classic optimization solvers (e.g., QP solver like ProxQP), notably for large geometries composed of tens or hundred of vertices.

HPP-FCL performances

Acknowledgments

The development of HPP-FCL is actively supported by the Gepetto team @LAAS-CNRS, the Willow team @INRIA and, to some extend, Eureka Robotics.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hpp_fcl-2.3.7.tar.gz (3.0 MB view hashes)

Uploaded Source

Built Distributions

hpp_fcl-2.3.7-0-cp312-cp312-musllinux_1_1_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ x86-64

hpp_fcl-2.3.7-0-cp312-cp312-manylinux_2_28_x86_64.whl (2.3 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.28+ x86-64

hpp_fcl-2.3.7-0-cp312-cp312-manylinux_2_28_aarch64.whl (2.3 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.28+ ARM64

hpp_fcl-2.3.7-0-cp312-cp312-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.12 macOS 10.9+ x86-64

hpp_fcl-2.3.7-0-cp311-cp311-musllinux_1_1_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ x86-64

hpp_fcl-2.3.7-0-cp311-cp311-manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.28+ x86-64

hpp_fcl-2.3.7-0-cp311-cp311-manylinux_2_28_aarch64.whl (2.3 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.28+ ARM64

hpp_fcl-2.3.7-0-cp311-cp311-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.11 macOS 10.9+ x86-64

hpp_fcl-2.3.7-0-cp310-cp310-musllinux_1_1_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ x86-64

hpp_fcl-2.3.7-0-cp310-cp310-manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.28+ x86-64

hpp_fcl-2.3.7-0-cp310-cp310-manylinux_2_28_aarch64.whl (2.3 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.28+ ARM64

hpp_fcl-2.3.7-0-cp310-cp310-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

hpp_fcl-2.3.7-0-cp39-cp39-musllinux_1_1_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ x86-64

hpp_fcl-2.3.7-0-cp39-cp39-manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.28+ x86-64

hpp_fcl-2.3.7-0-cp39-cp39-manylinux_2_28_aarch64.whl (2.3 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.28+ ARM64

hpp_fcl-2.3.7-0-cp39-cp39-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

hpp_fcl-2.3.7-0-cp38-cp38-musllinux_1_1_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ x86-64

hpp_fcl-2.3.7-0-cp38-cp38-manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.28+ x86-64

hpp_fcl-2.3.7-0-cp38-cp38-manylinux_2_28_aarch64.whl (2.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.28+ ARM64

hpp_fcl-2.3.7-0-cp38-cp38-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page