Knee Isokinetic Analysis

Project Description

This project provides a complete workflow for processing and analyzing isokinetic data, including:

• Converting raw dynamometer data into standardized csv files
• Signal filtering
• Extracting biomechanical parameters
• Generating individual figures
• Creating a results table for statistical analysis
• Performing statistical analyses and visualizing results

Structure

isokinetics
├── data
│   ├── raw # raw data
│   ├── processed # preprocessed data
├── scripts # pipeline scripts
├── reports # results
│   ├── figures
│   ├── tables
├── .gitignore
├── config.py # path management
├── pyproject.toml # project dependencies
├── README.md
└── uv.lock

CSV File Structure

Each CSV file contains 7 columns:

• SIDE: Left; Right
• Set: 1 = 60°/s; 2 = 240°/s
• Rep: number of repetitions (60°/s = 3 repetitions; 240°/s = 5 repetitions)
• mSec: time (ms)
• TORQUE: torque (Nm)
• ANAT: angle (°)
• VELOCITY: angular velocity (°/s)

Pipeline Workflow

1. Data Preprocessing (scripts/preprocessing.py)

• Create output directory
• Import .txt files
• Read data while removing dynamometer-specific metadata
• Clean data
• Handle missing data
• Save data

2. Biomechanical Analysis (scripts/main.py)

• Signal filtering
• Define experimental conditions
• Calculate biomechanical parameters
  • Peak torque
  • Agonist/antagonist ratio
  • Angle at peak torque
  • Time to peak torque
  • Left/right deficit
  • Maximum work
  • Total work
• Generate torque–time and torque–angle figures
• Export final table results.csv

3. Statistical Analyses (scripts/statistics.py)

• Descriptive statistics
• Inferential tests
• Generate figures (boxplot)
• Export stats_des.csv and stats_inf.csv files

Installation

1. Clone the repository

git clone https://github.com/hugohaffad/isokinetics.git
cd isokinetics

2. Install Python environment

uv sync

3. Run the pipeline

uv run scripts/preprocessing.py
uv run scripts/main.py
uv run scripts/statistics.py