Gait & Kinematic Dashboard¶
Plugin status - research in progress
The IntegraPose plugin ecosystem evolves with active research. Some plugins are stable, others are works in progress, and the set may change as research needs shift. Pin to a commit if you depend on a specific plugin for an in-flight project.
The Gait & Kinematic Dashboard turns pose tracks into stride-level locomotion metrics: stride length, stride duration, speed, paw angle, step length, step width, and group-level comparisons. It reuses the keypoint stream from Tab 4 / Tab 6 / Tab 7, so no extra labeling is needed once you have a working pose model.
When to use it¶
| Best for | Less ideal for |
|---|---|
| Locomotion studies - gait disorders, treatment effects, developmental locomotion | Behavioral studies that don't depend on stride-level kinematics |
| Comparing groups (e.g., WT vs KO) on standardized locomotion metrics | Single-track exploratory work where bout/event analysis is enough |
| Side-view or overhead recordings where paw / limb keypoints are reliable | Recordings where keypoint occlusion is severe |
What it produces¶
| Metric | What it tells you |
|---|---|
| Stride length | Distance covered per stride per paw |
| Stride duration | Time per stride |
| Speed | Track speed in pixels / sec (convert to physical units post-hoc) |
| Step length / width | Inter-paw stride geometry |
| Paw angle | Paw orientation relative to direction of travel |
| Group comparisons | Per-group means, distributions, and statistical comparisons |
All metrics are emitted in pixels by default - IntegraPose's standardized unit. Convert to physical units (mm, cm) using your own calibration after export.
What it does¶
- Reads the pose-track stream from a project, Tab 6 manifest, or batch run.
- Detects strides per paw using configurable rolling-window heuristics.
- Computes per-stride and per-track metrics.
- Renders a dashboard with per-group distributions and side-by-side comparisons.
- Exports CSVs ready for downstream statistics.
Practical advice¶
- Pose accuracy is the upstream constraint; if paw keypoints have low confidence, gait metrics will be noisy. Re-train or re-augment the pose model first.
- The default rolling window assumes ~30 fps. Higher frame rates can use a longer window without losing temporal resolution.
- Group videos by condition before importing so the dashboard's group comparisons line up with your study design.
Where this fits in the GUI workflow¶
Pose model
-> Inference (or Batch Processing Wizard)
-> Bout Analytics (optional, for ROI context)
-> Gait & Kinematic Dashboard
The dashboard is complementary to Behavior Clustering: SBD splits classes into kinds of walking, and Gait Kinematics quantifies each one's stride-level signature.