Skip to main content

NDCurves

Pipeline status Coverage report

A template-based Library for creating curves of arbitrary order and dimension, eventually subject to derivative constraints. The main use of the library is the creation of end-effector trajectories for legged robots.

To do so, tools are provided to:

  • create exact splines of arbitrary order (that pass exactly by an arbitrary number waypoints)
  • constrain initial / end velocities and acceleration for the spline.
  • constrain take-off and landing phases to follow a straight line along a given normal (to avoid undesired collisions between the effector and the contact surface)
  • automatically handle 3d rotation of the effector.
  • create curves in SO3
  • support partial symbolic differentiation of curves. You can represent control points as linear variables, and integrate / differentiate those variable curves. You can also compute the cross product of two curves, which is relevant for centroidal dynamics.

Several type of formulation are provided:

  • Polynomials
  • Bezier
  • Hermite (only cubic hermite for now)

The library is template-based, thus generic: the curves can be of any dimension, and can be implemented in double or float and can work with kind variables like Vector, Transform, Matrix, ...

Installation

This package is available as binary in robotpkg

Dependencies

Additional dependencies for python bindings

To handle this with cmake, use the recursive option to clone the repository. For instance, using http:

git clone --recursive https://github.com/loco-3d/ndcurves $NDCURVES_DIR

Where $NDCURVES_DIR is to be replaced to your selected source folder. The library is header only, so the build only serves to build the tests and python bindings:

cd $NDCURVES_DIR && mkdir build && cd build
cmake .. && make && make test

If everything went fine you should obtain the following output:

100% tests passed, 0 tests failed out of 3

Optional: Python bindings installation

To install the Python bindings first enable the BUILD_PYTHON_INTERFACE option:

cmake -DBUILD_PYTHON_INTERFACE=ON ..

Then rebuild the library:

cd ${NDCURVES_DIR}/build
make && make test

To see example of use, you can refer to the test file which is rather self explanatory:

In spite of an exhaustive documentation, please refer to the C++ documentation, which mostly applies to python.

Documentation and tutorial

For a python tutorial, you can refer to the jupyter notebook. The test file is more exhaustive and rather self explanatory.

Metadata

Release files for ndcurves 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for ndcurves 1.1.0
File Actions
ndcurves-1.1.0-1-cp39-cp39-manylinux_2_24_x86_64.whl CPython 3.9 CPython 3.9 Linux glibc 2.24+ x86-64 Details for ndcurves-1.1.0-1-cp39-cp39-manylinux_2_24_x86_64.whl
ndcurves-1.1.0-1-cp38-cp38-manylinux_2_24_x86_64.whl CPython 3.8 CPython 3.8 Linux glibc 2.24+ x86-64 Details for ndcurves-1.1.0-1-cp38-cp38-manylinux_2_24_x86_64.whl
ndcurves-1.1.0-1-cp37-cp37m-manylinux_2_24_x86_64.whl CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.24+ x86-64 Details for ndcurves-1.1.0-1-cp37-cp37m-manylinux_2_24_x86_64.whl
ndcurves-1.1.0-1-cp36-cp36m-manylinux_2_24_x86_64.whl CPython 3.6 CPython 3.6 pymalloc Linux glibc 2.24+ x86-64 Details for ndcurves-1.1.0-1-cp36-cp36m-manylinux_2_24_x86_64.whl
ndcurves-1.1.0-1-cp27-cp27mu-manylinux_2_24_x86_64.whl CPython 2.7 CPython 2.7 pymalloc wide-unicode Linux glibc 2.24+ x86-64 Details for ndcurves-1.1.0-1-cp27-cp27mu-manylinux_2_24_x86_64.whl

Total release size: 24.5 MB

Release files / ndcurves-1.1.0-1-cp39-cp39-manylinux_2_24_x86_64.whl

Download URL ndcurves-1.1.0-1-cp39-cp39-manylinux_2_24_x86_64.whl
Size 4.9 MB
Tags CPython 3.9 Linux glibc 2.24+ x86-64
SHA-256 checksum
How to use checksums
bf00c36e065a8b54a80f2ed47b78b0a3a66913ea2c8f36be444e7f881fb0188c
BLAKE2b-256 checksum
How to use checksums
3c8a14894b1bd5a0885650ecfa88ee50942e5ec1e084a550d356d0631cd4b085
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Release files / ndcurves-1.1.0-1-cp38-cp38-manylinux_2_24_x86_64.whl

Download URL ndcurves-1.1.0-1-cp38-cp38-manylinux_2_24_x86_64.whl
Size 4.9 MB
Tags CPython 3.8 Linux glibc 2.24+ x86-64
SHA-256 checksum
How to use checksums
23b955bfe5ede3e3e7d2847e1517c3c9edcdf50c6f7411f27bf02d137ee31156
BLAKE2b-256 checksum
How to use checksums
2f7c75736825d2bf0f4035ddf53d1f9a9816ed35d80ea5a375342f315812b806
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Release files / ndcurves-1.1.0-1-cp37-cp37m-manylinux_2_24_x86_64.whl

Download URL ndcurves-1.1.0-1-cp37-cp37m-manylinux_2_24_x86_64.whl
Size 4.9 MB
Tags CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.24+ x86-64
SHA-256 checksum
How to use checksums
7e6e54f2773b18ca700ced2159efbafcb423b50d66909541e3fc2f36ea7369e1
BLAKE2b-256 checksum
How to use checksums
a410797d9b89590b546e5aab9f24c562bd7ab177ed81cd49b0d4d9a7a550a912
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Release files / ndcurves-1.1.0-1-cp36-cp36m-manylinux_2_24_x86_64.whl

Download URL ndcurves-1.1.0-1-cp36-cp36m-manylinux_2_24_x86_64.whl
Size 4.9 MB
Tags CPython 3.6 CPython 3.6 pymalloc Linux glibc 2.24+ x86-64
SHA-256 checksum
How to use checksums
2d9e09fe3ebc7dd4c93b2b595207d58d5f29a957268cba6c9b86d767eea89aac
BLAKE2b-256 checksum
How to use checksums
319a56430d29278cdc31370c6b240fc132003178dd4e518c4ab165834d334a13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Release files / ndcurves-1.1.0-1-cp27-cp27mu-manylinux_2_24_x86_64.whl

Download URL ndcurves-1.1.0-1-cp27-cp27mu-manylinux_2_24_x86_64.whl
Size 4.9 MB
Tags CPython 2.7 CPython 2.7 pymalloc wide-unicode Linux glibc 2.24+ x86-64
SHA-256 checksum
How to use checksums
43edfe69d0465efa161483ed876cea1551981be3cb4f4a615992b4d25bbeb214
BLAKE2b-256 checksum
How to use checksums
1697d5268c4f6316c38c85cb673f4ed8c27d71e7ce081e55ce2a1837cccb1604
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Security for ndcurves 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page