monomech 0.15.0

Single camera biomechanics library

MonoMech

MonoMech is a notebook-first Python library for monocular biomechanics and OpenSim workflows.

It supports two main entry paths:

1. Video-first

   • video -> 2D pose -> 3D world pose -> 3D global pose -> CSV / TRC -> OpenSim scale / IK / ID

2. Marker-first

   • existing TRC / marker table -> smoothing / gap filling -> OpenSim scale / IK / ID

Install

pip install monomech

For MediaPipe-based pose estimation:

pip install "monomech[pose]"

For notebooks and plotting:

pip install "monomech[notebook]"

OpenSim

OpenSim is not installed through PyPI by this package. Install it in your conda environment first, then install monomech.

Example:

conda install -c opensim-org opensim
pip install monomech

Design principles

• notebook-friendly result objects
• strong smoothing and gap-filling options
• model-aware TRC export
• OpenSim wrappers that work with either MonoMech-generated TRCs or lab marker TRCs
• explicit quality-control metadata

Quick example

import monomech as mm

trial = mm.load_video("trial.mp4")
pose2d = trial.estimate_pose2d()
pose3d_world = trial.estimate_pose3d_world()
pose3d_global = trial.estimate_pose3d_global()

pose3d_global.to_trc("trial.trc", model_path="model.osim")

scale = trial.run_opensim_scale(model_path="model.osim", trc_path="trial.trc")
ik = trial.run_opensim_ik(model_path=scale.scaled_model_path, trc_path="trial.trc")

See the examples/ folder for full notebooks.