Skip to main content

Python utilites for movements in 3d space

Project description

=================
scikit-kinematics
=================

*scikit-kinematics* primarily contains functions for working with 3D
kinematics, e.g quaternions and rotation matrices.

Compatible with Python 2 and 3.

Dependencies
------------
numpy, scipy, matplotlib, pandas, sympy, easygui

Homepage
--------
http://work.thaslwanter.at/skinematics/html/

Author: Thomas Haslwanter
Date: 13-04-2016
Ver: 0.2.1
Licence: BSD 2-Clause License (http://opensource.org/licenses/BSD-2-Clause)
Copyright (c) 2016, Thomas Haslwanter
All rights reserved.

Installation
------------
You can install thlib with

pip install scikit-kinematics

and upgrade to a new version with

pip install scikit-kinematics -U

IMUs
====

Analysis of signals from IMUs (intertial-measurement-units).

General
-------
- kinematics.getXSensData ... Read in Rate and stored 3D parameters from XSens IMUs

MARG Systems
------------
- imus.calc_QPos ... Calculate orientation and position, from angular velocity and linear acceleration
- imus.kalman_quat ... Calculate orientation from IMU-data using an Extended Kalman Filter.

- imus.IMU ... Class for working with data from IMUs
- imus.IMU.calc_orientation ... calculate orientation
- imus.IMU.calc_position ... calculate position
- imus.IMU.setData ... set the properties of an IMU-object
- imus.MadgwickAHRS ... Class for calculating the 3D orientation with the Madgwick-algorithm
- imus.MahonyAHRS ... Class for calculating the 3D orientation with the Mahony-algorithm

Markers
=======

Analysis of signals from video-based marker-recordings of 3D movements

- markers.analyze3Dmarkers ... Kinematic analysis of video-basedrecordings of 3D markers
- markers.movement_from_markers ... 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.quatconj ... Conjugate quaternion
- quat.quatinv ... Quaternion inversion
- quat.quatmult ... Quaternion multiplication

Conversion routines - quaternions
---------------------------------

- quat.deg2quat ... Convert number or axis angles to quaternion vectors
- quat.quat2deg ... Convert quaternion to corresponding axis angle
- quat.quat2rotmat ... Convert quaternion to corresponding rotation matrix
- quat.quat2vect ... Extract the vector part from a quaternion
- quat.rotmat2quat ... Convert a rotation matrix to the corresponding quaternion
- quat.vect2quat ... Externd a quaternion vector to a unit quaternion.
- quat.vel2quat ... Calculate orientation from a starting orientation and angular velocity.


Rotation Matrices
=================

Definition of rotation matrices
-------------------------------

- rotmat.R1 ... 3D rotation matrix for rotation about the 1-axis
- rotmat.R2 ... 3D rotation matrix for rotation about the 2-axis
- rotmat.R3 ... 3D rotation matrix for rotation about the 3-axis

Conversion Routines - rotation matrices
---------------------------------------
- rotmat.rotmat2Fick ... Calculation of Fick angles
- rotmat.rotmat2Helmholtz ... Calculation of Helmholtz angles

Symbolic matrices
-----------------

- rotmat.R1_s() ... symbolix matrix for rotation about the 1-axis
- rotmat.R2_s() ... symbolix matrix for rotation about the 2-axis
- rotmat.R3_s() ... symbolix matrix for rotation about the 3-axis

For example, you can e.g. generate a Fick-matrix, with

>>> R_Fick = R3_s() * R2_s() * R1_s()

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 ... Projection of one vector onto another one
- vector.GramSchmidt ... Gram-Schmidt orthogonalization of three points
- vector.qrotate ... Quaternion indicating the shortest rotation from one vector into another.
- vector.rotate_vector ... Rotation of a vector

Interactive Data Analysis
=========================

- viewer.ts ... interactive viewer for time series data

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

scikit-kinematics-0.2.1.zip (1.1 MB view details)

Uploaded Source

Built Distribution

scikit-kinematics-0.2.1.win-amd64.exe (181.0 kB view details)

Uploaded Source

File details

Details for the file scikit-kinematics-0.2.1.zip.

File metadata

File hashes

Hashes for scikit-kinematics-0.2.1.zip
Algorithm Hash digest
SHA256 71faec418965f67bf12172af2c3297b2c92c5e8857f5f0daceaf2902aa27e473
MD5 cdab116a3ef69340c01db07fa2150c94
BLAKE2b-256 02fb5b5f15704c31f8fd459479190a3f316a4741e7a62d3c26c2b8bdb83263c1

See more details on using hashes here.

File details

Details for the file scikit-kinematics-0.2.1.win-amd64.exe.

File metadata

File hashes

Hashes for scikit-kinematics-0.2.1.win-amd64.exe
Algorithm Hash digest
SHA256 6d9911abb887ca0bde78ad3a00fd2ec1c9052bb9c2fde0af8ee71a61e133ddcd
MD5 90785db35eeab84e3e759f8c8b8c993b
BLAKE2b-256 d1e382644374bfc47f6263deb7d6a8c905eefa6f8def57181fea68153abc1de9

See more details on using hashes here.

Supported by

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