Tutorials¶

PrimateFace provides practical tutorials demonstrating various applications of primate facial analysis across different species and use cases.

Available Tutorials¶

🐵 Application Notebooks¶

Our Jupyter notebooks demonstrate real-world applications:

1. Lemur Face Visibility Time-Stamping¶

Track when lemur faces are visible in video footage for behavioral analysis.

2. Macaque Face Recognition¶

Identify individual macaques using facial landmarks and features.

3. Howler Vocal-Motor Coupling¶

Analyze facial movements during vocalizations in howler monkeys.

4. Gaze Following Analysis¶

Track primate gaze direction for social behavior studies.

5. Data-Driven Discovery of Facial Actions¶

Use unsupervised methods to discover facial action patterns.

6. Cross-Subject Neural Decoding¶

Decode facial actions from neural recordings across subjects.

Running the Notebooks¶

Local Setup¶

# Clone the repository
git clone https://github.com/KordingLab/PrimateFace.git
cd PrimateFace

# Install dependencies
pip install -e .

# Launch Jupyter
jupyter notebook demos/notebooks/

Google Colab¶

Each tutorial is available on Google Colab for easy access without local setup:

Tutorial	Colab Link
Lemur Time-Stamping
Macaque Recognition
Gaze Following

Framework-Specific Examples¶

• Using with DeepLabCut
• Using with SLEAP
• Using with MMPose
• Using with Ultralytics

Need Help?¶

• Check our FAQ
• Report issues on GitHub
• Contact us at primateface@gmail.com