BiomechanicsToolbox

Purpose

A Python-based GUI designed to help with more efficient Biomechanics data processing and presentation. Please refer to the BiomechancisToolbox.docx for further information about capabilities and how to operate the program.

If downloading all files from the main branch to run in your own IDE or terminal, run the BiomechanicsToolbox.py script only to initiate the program- all other python scripts are for functions or subprocess calls.

Current Version: v1.0.0

Get the current release version here.

Changes In Progress for next Version

• SPSS ready event outputs
• Kinematic and Kinetic sampling frequency settings to adjust the automatic find window for Event Picking
• Adjust index output for events to be time-based
• Allowing for NaNs to be present in the case of missing events, identified by a different symbol that can be passed by SPSS

Package Installation

It is HIGHLY recommended to use a virtual environment and use: pip install -r ToolboxRequirements.txt to obtain the required packages and version as easily as possible.

Eexecutable Options

If you would like to use an executable version of the program instead of running it through the command line or an IDE, I've uploaded a ZIP file to Dropbox that contains the required files generated by PyInstaller.

Alternatively, you can download the Github folder BuildExecutable from the repository, navigate to that directory from a terminal/powershell and run the following code to generate an executable locally:

pyinstaller --onefile -i"BT_Icon.ico" BiomechanicsToolbox.py

Please note that the executable version of this program will often be considerably behind the standalone Python scripts.

Example Files

As of March 24th, 2024 there is a folder containing example input and output files for multiple functions. This will allow you to test the function inputs, understand the data/file structures required by the program, and look at expected outputs from these files.

Features

• Script Gen: generates Visual3D scripts and model files based on input templates with attached heights and weights.
• Batch: compiles all trials for multiple subject inputs for a given condition into a text file that can be rehaped into the original 3d array.
• Normalize: Normalize an input Batch file to 101 data points.
• Quality Check: Import a Batch file that plots all trials of given variables for the desired subjects to ensure time series consistency.
• Event Pick: Visually assess and change discrete events from the chosen variables for a selected subject and condition.
• Event Compile: Process mean and standard deviations of all discrete events for each condition used as input.
• Ensemble: Produce publication quality ensemble plots with desired axis label names, DPI, etc.
• SPM (partially implemented): Perform statistical parametric mapping on two groups and produce output plots of comparisons.
• EMG (not available)

Please reach out to me if you have feedback, bug reports, etc!