About LISBET#

LISBET (LISBET Is a Social BEhavior Transformer) is a machine learning model designed for analyzing social behavior in animals. Using body tracking data, LISBET can both discover new behavioral motifs and automate the annotation of known behaviors.

Warning

LISBET is currently in beta and under active development. If you encounter any issues or bugs, please report them on our GitHub repository. We welcome feedback and contributions from the community.

Getting Started

How to install LISBET and start annotating your data.

Getting Started
User Guide

Basic and advanced tutorials.

Analysis Examples
Analysis Examples

How to analyze behavioral annotations.

Analysis Examples

Definitions and Concepts#

Behavioral Embeddings#

LISBET processes body tracking coordinates through a transformer model to generate embeddings - compressed representations of social interactions. These embeddings capture the essential features of the behavior while filtering out noise and irrelevant details. The model learns these embeddings without human supervision by solving several self-supervised tasks. For example, it learns to detect when animals are genuinely interacting versus being artificially paired by sampling their tracking data from different sources.

Behavioral Motifs#

Motifs are distinct patterns of social interaction that LISBET identifies from the embeddings without human supervision. Unlike human-defined behaviors, motifs emerge purely from the data and may not correspond to behaviors that humans typically recognize or label. This makes them particularly valuable for discovering patterns that might be missed by traditional human observation.

Analysis Approaches#

Classification Mode (Supervised)#

In classification mode, LISBET can be trained to recognize specific human-defined behaviors. This approach requires some human-annotated examples but effectively automates labor-intensive manual scoring and maintains consistency across large datasets.

For a detailed guide on using this approach, see Social behavior classification using a pre-trained model in the User Guide.

Discovery Mode (Unsupervised)#

In discovery mode, LISBET automatically segments social interactions into motifs without requiring any human input. These motifs represent recurring patterns in the data that the model identifies as distinct. While some motifs might align with known behaviors, others might reveal subtle or previously unnoticed patterns of interaction. This approach is particularly useful for phenotyping and comparing different experimental groups without human bias.

For a detailed guide on using this approach, see Social behavior discovery using a pre-trained model in the User Guide.

Design Philosophy#

LISBET works with standard body tracking data from common tools like DeepLabCut and SLEAP. The model captures interactions across multiple timescales and can correlate motifs with neural recordings, making it particularly valuable for neuroscience research.

A key feature of LISBET is the use of self-supervised tasks to learn meaningful representations of social behavior directly from data, without relying solely on human annotation. These tasks challenge the model to understand the structure, timing, and dynamics of social interactions by solving auxiliary prediction problems constructed from the data itself. By doing so, LISBET learns to focus on the aspects of behavior that are most relevant for social analysis, such as synchrony, causality, and invariance to speed or identity.

To learn more about these self-supervised tasks and how they shape LISBET’s understanding of behavior, see Self-Supervised Tasks.

The design of LISBET addresses fundamental challenges in social behavior research by moving beyond human-defined behavioral categories. By identifying motifs in an unbiased way and also providing tools for traditional behavior classification, LISBET offers a comprehensive approach to understanding social interactions.

Whether you are looking for new motifs, automating behavior annotation, or linking social interaction patterns to neural activity, LISBET provides a flexible and powerful toolkit for social behavior analysis.

References#

@misc{chindemi2023lisbet,
   title={LISBET: a machine learning model for the automatic segmentation of social behavior motifs},
   author={Giuseppe Chindemi and Benoit Girard and Camilla Bellone},
   year={2023},
   eprint={2311.04069},
   archivePrefix={arXiv},
   primaryClass={cs.CV}
}