Obsolete. In date of June 20th 2025, all extensions are migrated to the new kineticstoolkit_extensions package, which can be installed using pip or conda. The new extension mechanism, which has been selected to maximize the stability of the code in time (for example by running unit tests continuously) is explained here.
To use the pushrimkinetics extension, we now install kineticstoolkit_extensions and we use pushrimkinetics functions using:
import kineticstoolkit_extensions.pushrimkinetics as pk
pk.function1()
pk.function2()
etc.
This repository will be archived or deleted in the future.
Old description below.
Provide functions to process kinetic data from instrumented wheelchair wheels such as the SmartWheel, pictured below.
The functions provided by this module are:
read_smartwheel(filename): Read a file generated by the SmartWheel instrumented wheel.apply_calibration(ts, gains, offsets, *, transducer, reference_frame): Calculate pushrim forces and moments based on raw channel values.remove_offsets(ts, baseline_kinetics): Remove dynamic offsets in forces and moments.calculate_velocity(ts): Calculate velocity based on wheel angle.calculate_power(ts): Calculate power based on wheel velocity and moment.
- Copy
kineticstoolkit_pushrimkinetics.pyin your working directory; - Import it, for example using
import kineticstoolkit_pushrimkinetics as pk.
Please refer to this tutorial to see the extension in action.
This module was formely a Kinetics Toolkit extension. As of June 2025, it has been converted to a simpler module that you simply download and add to your Python path or working directory. KTK extensions are being progressively phased out toward this much simpler method.