scikit-kinematics
scikit-kinematics primarily contains functions for working with 3D kinematics, e.g quaternions and rotation matrices. This includes utilities to read in data from the following IMU-sensors: - polulu - XSens - xio - xio-NGIMU - YEI
Compatible with Python >= 3.12
Dependencies
numpy, scipy, matplotlib, pandas, sympy, easygui
Homepage
http://work.thaslwanter.at/skinematics/html/
Author: Thomas Haslwanter Date: 21-Jul-2026 Ver: 0.12.0 Licence: BSD 2-Clause License (http://opensource.org/licenses/BSD-2-Clause) Copyright (c) 2026, Thomas Haslwanter All rights reserved.
Installation
You can install scikit-kinematics with
pip install scikit-kinematics
and upgrade to a new version with
pip install --upgrade --no-deps scikit-kinematics
IMUs
Analysis of signals from IMUs (intertial-measurement-units). Read in data, calculate orientation (with one of the algorithms below)
- get_data ... This method must be taken from one of the existing
sensors, or from your own sensor. Currenlty the following sensors
types are available:
-
XSens
-
xio (XIO, NGIMU, and XIO3)
-
yei
* polulu
-
- calc_position
MARG Systems
- imus.analytical ... Calculate orientation and position, from angular velocity and linear acceleration
- imus.kalman ... Calculate orientation from IMU-data using an Extended Kalman Filter.
imus.IMU ... Class for working with data from IMUs
: - imus.IMU.calc\_position ... calculate position
- imus.IMU.setData ... set the properties of an IMU-object
- imus.IMU.set\_qtype ... sets q\_type, and automatically
performs the relevant calculations.
- imus.Madgwick ... Class for calculating the 3D orientation with the Madgwick-algorithm
- imus.Mahony ... Class for calculating the 3D orientation with the Mahony-algorithm
Markers
Analysis of signals from video-based marker-recordings of 3D movements
- markers.analyze_3Dmarkers ... Kinematic analysis of video-based recordings of 3D markers
- markers.find_trajectory ... Calculation of joint-movements from 3D marker positions
Quaternions
Note that all these functions work with single quaternions and quaternion vectors, as well as with arrays containing these.
Quaternion class
quat.Quaternion ... class, including overloading for multiplication and
: division (e.g. "quatCombined = quat1 \* quat2"), import and
export
Functions for working with quaternions
- quat.q_conj ... Conjugate quaternion
- quat.q_inv ... Quaternion inversion
- quat.q_mult ... Quaternion multiplication
- quat.q_scalar ... Extract the scalar part from a quaternion
- quat.q_vector ... Extract the vector part from a quaternion
- quat.unit_q ... Extend a quaternion vector to a unit quaternion.
Conversion routines - quaternions --------------------------------=
- quat.calc_angvel ... Calculates the velocity in space from quaternions
- quat.calc_quat ... Calculate orientation from a starting orientation and angular velocity.
- quat.convert ... Convert quaternion to corresponding rotation matrix or Gibbs vector
- quat.deg2quat ... Convert number or axis angles to quaternion vectors
- quat.quat2seq ... Convert quaternions to sequention rotations ("nautical" angles, etc)
- quat.scale2deg ... Convert quaternion to corresponding axis angle
Rotation Matrices
Definition of rotation matrices ------------------------------=
- rotmat.R ... 3D rotation matrix for rotation about a coordinate axis
- rotmat.R_2d ... 2D rotation matrix
Conversion Routines - rotation matrices --------------------------------------=
- rotmat.convert ... Convert a rotation matrix to the corresponding quaternion
- rotmat.seq2quat ... Convert nautical angles etc. to quaternions
- rotmat.sequence ... Calculation of Euler, Fick, Helmholtz, ... angles
Symbolic matrices
- rotmat.R_s() ... symbolix matrix for rotation about a coordinate axis
- rotmat.R_2d_s() ... symbolix 2D matrix
For example, you can e.g. generate a Fick-matrix, with
>>> R_Fick = R_s(2, 'theta') * R_s(1, 'phi') * R_s(0, 'psi')
Spatial Transformation Matrices
- rotmat.stm ... spatial transformation matrix, for combined rotations/translations
- rotmat.stm_s() ... symbolix spatial transformation matrix
Denavit-Hartenberg Transformations
- rotmat.dh ... Denavit-Hartenberg transformation matrix
- rotmat.dh_s ... symbolic Denavit-Hartenberg transformation matrix
Vectors
Routines for working with vectors These routines can be used with vectors, as well as with matrices containing a vector in each row.
- vector.normalize ... Vector normalization
- vector.project_onto_line ... Projection of one vector onto another
- vector.project_into_plane ... Projection of one vector into a plane
- vector.GramSchmidt ... Gram-Schmidt orthogonalization of three points
- vector.q_shortest_rotation ... Quaternion indicating the shortest rotation from one vector into another.
- vector.rotate_vector ... Rotation of a vector
- vector.target2orient ... Convert target location into orientation angles
Interactive Data Analysis ========================-
- viewer.ts ... interactive viewer for time series data
- view.orientation ... visualize and animate orientations, expressed as quaternions.
Simulations
- simulate_movements ... calculated ideal IMU-signals for combined rotations/translations
Errata
The file Errata.pdf contains the a list of mistakes in the manuscript, and the corresponding corrections.
1 maintainer
Release files for scikit-kinematics 0.12.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 | |
|---|---|---|---|
| scikit_kinematics-0.12.0.tar.gz | 66.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scikit_kinematics-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 141.0 MB
Release files / scikit_kinematics-0.12.0.tar.gz
| Download URL | scikit_kinematics-0.12.0.tar.gz |
|---|---|
| Size | 66.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
805afa1b1febc856590a55caac5486dea279b7263716446f830014877cd73e39
|
|
BLAKE2b-256 checksum How to use checksums |
b881f6b900ecd1a0528d45433dde251cb0e9ea51aa3305fed62a7b2aeaffe052
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / scikit_kinematics-0.12.0-py3-none-any.whl
| Download URL | scikit_kinematics-0.12.0-py3-none-any.whl |
|---|---|
| Size | 74.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6872f825fbc79282f9e4db1fa194265873739df67242916979ff134d8597242c
|
|
BLAKE2b-256 checksum How to use checksums |
258b38bd6792e093c4ccb9ab68f8c4445371d3491715b747754e955ce0530d5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
