Skip to main content

ikfast_pybind

Travis CI License MIT PyPI - Python Version PyPI - Latest Release

ikfast_pybind is a python binding generation library for the analytic kinematics engine IKfast. The python bindings are generated via pybind11 a CMake-based build system.

Note: You need the ikfast .h and .cpp ready to generate the python bindings. This URDF-to-cpp generation part needs to be done with openrave and IS NOT done by this repo, please see this tutorial for details.

The assembly sequence and motion planning framework pychoreo relies on this library to generate compatible IK modules for robots across brands, scales, and dofs.

Prerequisites

ikfast_pybind depends on the following dependencies, which come from pybind11 for building the python bindings.

On Unix (Linux, OS X)

  • A compiler with C++11 support

  • CMake >= 2.8.12

On Windows

  • Visual Studio 2015 (required for all Python versions, see notes below)

  • CMake >= 3.1

It is recommended (especially for Windows users) to test the environment with the cmake_example for pybind11 before proceeding to build conmech.

Installation

git clone --recursive https://github.com/yijiangh/ikfast_pybind
cd ikfast_pybind
pip install .
# try with '--user' if you encountered a sudo problem

For developers:

git clone --recursive https://github.com/yijiangh/ikfast_pybind
cd ikfast_pybind
python setup.py sdist
pip install --verbose dist/*.tar.gz

With the setup.py file included in the base folder, the pip install command will invoke CMake and build the pybind11 module as specified in CMakeLists.txt.

References

Citation

If you find IKFast useful, please cite OpenRave:

@phdthesis{diankov_thesis,
  author = "Rosen Diankov",
  title = "Automated Construction of Robotic Manipulation Programs",
  school = "Carnegie Mellon University, Robotics Institute",
  month = "August",
  year = "2010",
  number= "CMU-RI-TR-10-29",
  url={http://www.programmingvision.com/rosen_diankov_thesis.pdf},
}

0.1.2

Fixed - Fix pypi wheel build issue

Changed - Skip UR robot tests for now

0.1.1

Added - Added support for kawasaki_rs010n robot

Changed - Reorganize test files to having a test file for each robot type.

Updated - pybind11 set to track master, commit e08a58111, which should fix pip installation issue.

0.1.0

Available robots - kuka_kr6_r900 (tested) - ur3 - ur5 - abb_irb4600_40_255 - franka_panda (tested) - eth_rfl (tested)

Added Modules for franka_panda, eth_rfl robots.

Add ifkast modules for ur5, kuka_kr6_r900, abb_irb4600. abb_irb4600 test fails some time randomly - need to regenerate its IKfast cpp files (might be the floating point truncation issue).

Include the upstreamed ur_kinematics commit 6734142 July 2 2019 but it seems that the old one works more stably… I will do more tests on this.

Metadata

Release files for ikfast-pybind 0.1.2

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

Source distribution (sdist)

Source distribution for ikfast-pybind 0.1.2
File Size Uploaded Provenance
ikfast_pybind-0.1.2.tar.gz 429.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ikfast-pybind 0.1.2
File Interpreter ABI Platform
ikfast_pybind-0.1.2-cp37-cp37m-win_amd64.whl CPython 3.7 CPython 3.7 pymalloc Windows x86-64 Details

Total release size: 1.6 MB

Release files / ikfast_pybind-0.1.2.tar.gz

Download URL ikfast_pybind-0.1.2.tar.gz
Size 429.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e587f47c8983b8ff7271edc795057a0208d196f23d563175e33409f70a6a7505
BLAKE2b-256 checksum
How to use checksums
7401c9455d440ef7223f9da0b8322b1784a141fdef054e8966f42e4d94c4950e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.16

Release files / ikfast_pybind-0.1.2-cp37-cp37m-win_amd64.whl

Download URL ikfast_pybind-0.1.2-cp37-cp37m-win_amd64.whl
Size 1.2 MB
Tags CPython 3.7 CPython 3.7 pymalloc Windows x86-64
SHA-256 checksum
How to use checksums
cc8fa71513c0ad4175ddf85b3941d5333b25731551a7c83a3c3db34fc542c00a
BLAKE2b-256 checksum
How to use checksums
23c2495512a2921aa6edbc95e946a2aa6e62f417f82ab4d080b552fc33636fe9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.16

Security for ikfast-pybind 0.1.2

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