analysis / README.md
abdelkader9090's picture
Initial release
e67ded9
|
Raw History Blame Contribute Delete
1.26 kB
---
title: SPORALIZE
emoji: πŸƒ
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "5.9.1"
app_file: app.py
pinned: false
license: mit
---
# SPORALIZE β€” 3D Stereo Biomechanics Analysis
Upload two synchronized camera videos and your stereo calibration file.
SPORALIZE runs **RTMPose Wholebody** (133 keypoints including full foot detail),
triangulates the 3D skeleton, and produces an interactive biomechanics dashboard.
## Inputs
| File | Description |
|---|---|
| `cam0.mp4` | Primary camera video |
| `cam1.mp4` | Secondary camera video (synchronized) |
| `calib.pkl` | Hybrid stereo calibration pickle (K1/K2/R/T/R_world/origin/SCALE) |
## Outputs
- **Live frame preview** β€” both cameras with skeleton overlay, scrub with slider
- **Metrics dashboard** β€” active angle, foot orientation, knee/hip angles, torso pitch/roll, head angle
- **Head angle chart** β€” color-coded above/below configurable threshold
- **3D pose viewer** β€” interactive Plotly 3D skeleton with foot keypoints highlighted
- **SPORALIZE JSON** β€” downloadable, compatible with the full SPORALIZE React app
## Model
RTMPose-m Wholebody (133 keypoints) via [rtmlib](https://github.com/Tau-J/rtmlib).
ONNX weights are downloaded automatically on first run (~40 MB).