Skip to content

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

42 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

C3D-preprocessing

This repository will help you pre-process your motion capture data for use in OpenSim. You DO NOT need to have the OpenSim package installed or configured to use these scripts. This repository is for PREPARING your data for use in OpenSim and does not require OpenSim as a dependency.

OpenSim currently only support 3rd-order Butterworth low-pass filtering. With these simple processing scripts, you can extract .c3d files, apply any filter order or cutoff frequency and obtain the resulting OpenSim .mot and .sto data files. Additionally, these scripts recalculate the COP after low-pass filtering of the raw data to ensure data accuracy.

The ezc3d library is excellent for .c3d file processing and it must be installed prior to running the processing scripts.

The Kuopio Full-Body Dataset contains motion trials which have been tested with these scripts.

MATLAB

MATLAB testing and processing has been developed and tested on Linux with MATLAB 2026a but should work with other OS and platform combinations.

Environment Setup

  1. Install MATLAB for your OS
  2. Install the Signal Processing Toolbox by MathWorks in MATLAB for low-pass filtering
  3. Download the ezc3d MATLAB package for your OS. If you are a linux user, you may need to fix the mex GLIBC path. Instructions are provided in this issue.
  4. Unzip the folder, and add it to the MATLAB path (Home->Set Path->Add Folder & click Save path for future sessions).
  5. Set the parameters in matlab/process_c3d_trial.m and run it!

Python

The Python scripts includes the same functionality as the MATLAB scripts, with improved parallel processing for efficient bulk trial processing.

Environment Setup

  1. Install uv
  2. cd python and then uv venv
  3. source .venv/bin/activate
  4. uv pip install -e .
  5. python scripts/process_c3d_trials.py

NOTE: you can also use python -m venv .venv or any other python venv method.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages