Worklab Documentation#

image image image

Date: Sep 28, 2023

The current page contains information on wheelchair propulsion research in the worklab and the correspondingly named Python package. As such, the page contains a general outline of wheelchair propulsion research, but also some practical examples on how to work with that data together with the API-reference of the package. The worklab package aims to provide functions for the most common data (pre-)processing steps in wheelchair research (at our lab). As such, it is mainly focussed on the hardware that is available in the worklab at the University Medical Center Groningen. It makes extensive use of pandas dataframes as those are familiar to most researchers and uses a (mostly) functional approach.

🚀 Quick Start Guide

Jump straight to the documentation on how to install the worklab package on your machine. This section also covers the fundamentals of wheelchair research and data analysis.

👍 Minimal examples

This part provides you with a set of small examples that you can use to kickstart your analysis. The examples are used to showcase the functionality of the package while also showing you some good-practices.

🙌 Package documentation

The API documentation provides a nicely rendered version of all the docstrings in the worklab package. This allows you to search for functions in the documentation and read them in a way that is easy on the eyes.

🌍 Developer information

If you wish to contribute to the worklab package this is the place to be. Have a look at these pages to get your development environment up and running and your first pull request going.

Authors#

Citing#

If you want to refer to this package please use this DOI: 10.5281/zenodo.8362962, or cite:

Rick de Klerk, Thomas Rietveld, Rowie Janssen, & Jelmer Braaksma. (2023). Worklab: a wheelchair biomechanics mini-package. Zenodo. https://doi.org/10.5281/zenodo.8362963

Acknowledgments#

  • Thanks to R.J.K. Vegter for providing information on the Optipush and SMARTwheel systems.

  • Thanks to R.M.A. van der Slikke for providing information on skid correction.

  • Thanks to the people at Umaco for answering my questions however dumb they may be.

References#

Functions that use a specific algorithm or base have their references in the docstring. More generally, the analyses in this package are taken from:

  • Janssen RJF, Vegter RJK, Houdijk H, van der Woude LHV and de Groot S (2022). Evaluation of a standardized test protocol to measure wheelchair-specific anaerobic and aerobic exercise capacity in healthy novices on an instrumented roller ergometer. PLOS ONE 17(9): e0274255. https://doi.org/10.1371/journal.pone.0274255

  • De Klerk R, Vegter RJK, Veeger HEJ and van der Woude LHV (2020). Technical Note: A Novel Servo-Driven Dual-Roller Handrim Wheelchair Ergometer. IEEE Transactions on Neural Systems and Rehabilitation Engineering, 28(4), 953-960. https://doi.org/10.1109/TNSRE.2020.2965281

  • De Klerk R, Vegter RJK, Leving MT, de Groot S, Veeger HEJ, van der Woude LHV (2020). Determining and Controlling External Power Output During Regular Handrim Wheelchair Propulsion. J Vis Exp. 156. https://doi.org/10.3791/60492

  • Rietveld T, Vegter RJK, van der Slikke RMA, Hoekstra AE, van der Woude LHV and de Groot S (2019). Wheelchair mobility performance of elite wheelchair tennis players during four field tests: Inter-trial reliability and construct validity. PLoS One 14(6): e0217514. https://doi.org/10.1371/journal.pone.0217514

  • Vegter RJK, Lamoth CJ, de Groot S, Veeger HEJ and van der Woude LHV (2013). Variability in bimanual wheelchair propulsion: consistency of two instrumented wheels during handrim wheelchair propulsion on a motor driven treadmill. Journal of neuroengineering and rehabilitation, 10(1), 9. https://doi.org/10.1186/1743-0003-10-9

  • Van der Slikke RMA, Berger MAM, Bregman DJJ, & Veeger HEJ (2015). Wheel skid correction is a prerequisite to reliably measure wheelchair sports kinematics based on inertial sensors. Procedia Engineering, 112, 207-212. https://doi.org/10.1016/j.proeng.2015.07.201

  • Van der Slikke RMA, Berger MAM, Bregman DJJ and Veeger HEJ (2016). Push characteristics in wheelchair court sport sprinting. Procedia engineering, 147, 730-734. https://doi.org/10.1016/j.proeng.2016.06.265