bioRxivNeurosciencePreprint
Keypoint-MoSeq: parsing behavior by linking point tracking to pose dynamics
Caleb WeinrebiD, Jonah E PearliD, Sherry LiniD, Mohammed Abdal Monium OsmaniD, Libby ZhangiD, Sidharth Annapragada, Eli Conlin, Red Hoffman, Sofia Makowska, Winthrop F. GillisiD, Maya JayiD, Shaokai YeiD, Alexander MathisiD, Mackenzie Weygandt MathisiD, Talmo PereiraiD, Scott W. LindermaniD, Sandeep Robert DattaiD
Abstract
Keypoint tracking algorithms have revolutionized the analysis of animal behavior, enabling investigators to flexibly quantify behavioral dynamics from conventional video recordings obtained in a wide variety of settings. However, it remains unclear how to parse continuous keypoint data into the modules out of which behavior is organized. This challenge is particularly acute because keypoint data is susceptible to high frequency jitter that clustering algorithms can mistake for transitions between behavioral modules. Here we present keypoint-MoSeq, a machine learning-based platform for identifying behavioral modules ("syllables") from keypoint data without human supervision. Keypoint-MoSeq uses a generative model to distinguish keypoint noise from behavior, enabling it to effectively identify syllables whose boundaries correspond to natural sub-second discontinuities inherent to mouse behavior. Keypoint-MoSeq outperforms commonly used alternative clustering methods at identifying these transitions, at capturing correlations between neural activity and behavior, and at classifying either solitary or social behaviors in accordance with human annotations. Keypoint-MoSeq therefore renders behavioral syllables and grammar accessible to the many researchers who use standard video to capture animal behavior.
- organism: mouse
- assay: imaging
- research focus: clustering
- research focus: benchmarking
- approach: machine learning (classical)
Abstract summary
Claude Opus 5.5 · xhigh effort · 18 Oct 2026 · from the abstract · CC BY-NC-ND 4.0
Keypoint-MoSeq fits a generative model that tells tracking jitter apart from real movement, cutting pose time series into unsupervised sub-second behavioural syllables in mice.
Keypoint tracking lets investigators quantify pose from ordinary video, but there is no settled way to divide those continuous traces into the modules behaviour is built from, and clustering methods can mistake high-frequency jitter for a module boundary. Keypoint-MoSeq models that noise explicitly so the inferred boundaries land on genuine sub-second breaks in movement.
Key results
SuggestedModelling keypoint noise inside the generative model puts syllable boundaries on real discontinuities rather than on tracking artefacts.
Reported as unsupervised syllables whose edges match the natural sub-second breaks seen in mouse behaviour; no boundary-accuracy numbers appear in the abstract. · Abstract
SuggestedIt is reported to beat commonly used clustering approaches on three different criteria at once.
Better on detecting behavioural transitions, on recovering correlations between neural activity and behaviour, and on matching human annotation when classifying solitary or social behaviour; the baselines are not named and no metric values are given. · Abstract
ClaimedThe authors position the method as bringing syllable-level and grammar-level analysis to labs that record with standard video.
Stated as the practical upshot of working from standard video keypoints; no usability or adoption evidence is presented. · Abstract
Methods, data and reproducibility
Keypoint-MoSeq fits a generative model to keypoint trajectories that separates tracking noise from pose dynamics, then segments the series into recurring unsupervised modules termed syllables. It was compared against commonly used clustering methods on transition detection, on correlation with neural activity, and on agreement with human annotation of solitary and social behaviour.
- Keypoint tracking data derived from conventional video of mouse behaviour · mouse
- Neural activity recordings paired with behaviour, used to test behaviour-neural correlation
- Human annotations of solitary and social behaviour used as the classification reference
- Methods & tools
- keypoint-MoSeq
Limitations (2)
- The abstract reports no metrics at all: the advantage over other clustering methods is asserted without accuracy, agreement or correlation values, and without naming the baselines compared against. · noted in this summary
- The evidence described concerns mouse behaviour; whether the noise model holds for other species, camera setups or keypoint trackers is not addressed here. · noted in this summary
Read this if you turn pose tracking into behavioural modules and need a segmentation method that will not read keypoint jitter as a behavioural transition.
- Citations
- 65
Reproducibility ledger
Nobody has reported trying to reproduce this paper yet. Did you replicate an experiment or run the code? Your report saves the next lab a week.
Sign in to file a reproducibility report.
Related papers
- OpenLabCluster: Active Learning Based Clustering and Classification of Animal Behaviors in Videos Based on Automatically Extracted Kinematic Body Keypoints
J. Li, M. L. Keselman, E. Shlizerman·bioRxiv·Oct 10, 2022
- Unsupervised decomposition of natural monkey behavior into a sequence of motion motifs
Koki Mimura, Jumpei Matsumoto, … Takafumi Minamimoto·Communications BiologyPeer-reviewed·Sep 3, 2024
- VQ-MAP: a flexible, versatile framework for animal behavior understanding
Tianqing Li, Ugne Klibaite, … Timothy Dunn·bioRxiv·Dec 9, 2025
- SUBTLE: An unsupervised platform with temporal link embedding that maps animal behavior
Jea Kwon, Sunpil Kim, … Changjoon Justin Lee·International Journal of Computer VisionPeer-reviewed·May 20, 2024
- Discovering compositional, interpretable structure in social behavior
Yue Wan, Sai Koukuntla, … Adam Charles·bioRxiv·Nov 4, 2026
- FERAL: A Supervised Video-Understanding System for Direct Video-to-Behavior Mapping
Peter Skovorodnikov, Jacopo Razzauti, … Leslie B. Vosshall·bioRxiv·Nov 16, 2025