Robot Kinematics Library
A comprehensive, production-ready robotics kinematics library for Python that provides forward and inverse kinematics, Jacobian calculations, and advanced robotics analysis tools with URDF and PyBullet integration.
Author: Sherin Joseph Roy
Email: sherin.joseph2217@gmail.com
Repository: https://github.com/Sherin-SEF-AI/robot-kinematics
Features
- Forward Kinematics: DH parameters, URDF parsing, multiple robot configurations
- Inverse Kinematics: Numerical, analytical, and hybrid solvers
- Jacobian Analysis: Geometric and analytical Jacobians, singularity detection
- Robot Types: UR5, Panda, SCARA, Delta, KUKA KR5, Stewart platform, mobile manipulators
- Advanced Features: Workspace analysis, singularity avoidance, performance optimization
- Integration: URDF import/export, PyBullet visualization and animation
- High Performance: JIT compilation, caching, vectorized operations
Installation
Basic Installation
pip install robot-kinematics
With Visualization Support
pip install robot-kinematics[visualization]
Full Installation (All Dependencies)
pip install robot-kinematics[full]
Quick Start
import numpy as np
from robot_kinematics.robots.serial import UR5Manipulator, KUKAKR5Manipulator
from robot_kinematics.inverse.numerical import NumericalIK
from robot_kinematics.core.transforms import Transform
# Create a UR5 robot
ur5 = UR5Manipulator()
print(f"Robot: {ur5.config['name']}")
print(f"Number of joints: {ur5.n_joints}")
# Forward kinematics
joint_config = np.array([0, 0, 0, 0, 0, 0]) # Home position
pose = ur5.forward_kinematics(joint_config)
print(f"End-effector position: {pose.position}")
# Inverse kinematics
target_pose = Transform(position=np.array([0.4, 0.0, 0.5]))
ik_solver = NumericalIK(robot=ur5, method="damped_least_squares")
solution, success, error = ik_solver.solve(target_pose, joint_config)
if success:
print(f"IK solution: {solution}")
print(f"Error: {error}")
# Create KUKA KR5 robot
kuka = KUKAKR5Manipulator()
print(f"KUKA KR5 robot: {kuka.config['name']}")
URDF Integration
from robot_kinematics.integration.urdf_utils import load_robot_from_urdf
from robot_kinematics.robots.serial import SerialManipulator
# Load robot from URDF file
config = load_robot_from_urdf("robot.urdf")
robot = SerialManipulator(config)
PyBullet Visualization
from robot_kinematics.integration.pybullet_utils import connect_gui, create_kuka_kr5_pybullet, animate_trajectory
# Connect to PyBullet GUI
connect_gui()
# Load robot model
robot_id = create_kuka_kr5_pybullet()
# Animate trajectory
joint_trajectory = [q1, q2, q3, ...] # List of joint configurations
animate_trajectory(robot_id, joint_trajectory, dt=0.05)
Documentation
For detailed documentation, examples, and API reference, visit our documentation.
Supported Robot Types
- Serial Manipulators: UR5, Panda, SCARA, Delta, KUKA KR5
- Parallel Robots: Stewart platform, Delta parallel
- Mobile Manipulators: Dual-arm systems, mobile bases
Performance Features
- JIT Compilation: Using Numba for accelerated computations
- Caching: Thread-safe caching for repeated calculations
- Vectorization: Optimized NumPy operations
- Memory Management: Efficient memory usage for large-scale operations
Examples
Check the examples/ directory for comprehensive examples:
basic_usage.py- Basic kinematics operationssimple_advanced_example.py- Trajectory planning and analysispybullet_kuka_kr5_demo.py- PyBullet visualization demourdf_import_export_demo.py- URDF integration demo
Testing
Run the test suite:
pytest tests/
Contributing
We welcome contributions! Please see our contributing guidelines for details.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Citation
If you use this library in your research, please cite:
@software{robot_kinematics,
title={Robot Kinematics Library},
author={Sherin Joseph Roy},
year={2024},
url={https://github.com/Sherin-SEF-AI/robot-kinematics}
}
Metadata
Release files for robot-kinematics 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| robot_kinematics-1.1.0.tar.gz | 59.7 kB | Without provenance | Details for robot_kinematics-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| robot_kinematics-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for robot_kinematics-1.1.0-py3-none-any.whl |
Total release size: 118.2 kB
Release files / robot_kinematics-1.1.0.tar.gz
| Download URL | robot_kinematics-1.1.0.tar.gz |
|---|---|
| Size | 59.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c6b28e984b0ce9a1fb5d9d7527d23a45b50977942ad025a725edfcd3e1e25cad
|
|
BLAKE2b-256 checksum How to use checksums |
ae620cb2d34f64dced48f9ba8cf33bd4209b100e8e1e19ce2a9a290a4ac72e8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Release files / robot_kinematics-1.1.0-py3-none-any.whl
| Download URL | robot_kinematics-1.1.0-py3-none-any.whl |
|---|---|
| Size | 58.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab926cfc9452e67be0015e969489e2ec5493921a03cd644784edac68fffac074
|
|
BLAKE2b-256 checksum How to use checksums |
a2e6a0af5385d0c8cbaf7552095f390215830bcb7ead6e134db960441c358cc5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Security for robot-kinematics 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.