ChimpBehave

Abstract

In this paper, we introduce ChimpBehave, a novel dataset featuring over 2 hours of video (approximately 193,000 video frames) of zoo-housed chimpanzees, meticulously annotated with bounding boxes and behavior labels for action recognition. ChimpBehave uniquely aligns its behavior classes with existing datasets, allowing for the study of domain adaptation and cross-dataset generalization methods between different visual settings. Furthermore, we benchmark our dataset using a state-of-the-art CNN-based action recognition model, providing the first baseline results for both within and cross-dataset settings.

Examples - walking, sitting, standing, running, hanging, climbing down, climbing up

Data preparation

Download the ChimpBehave dataset found here: dataset, bboxes

Save it in the 'data' folder to match the following structure:

├── ...
├── data                                            # data folder
│   ├── chimpbehave                                 # chimpbehave dataset folder 
|   │   ├── bboxes                                  # bboxes annotations
|   │   |   ├── Benga1_364_778_bboxes.json          # training image (name irrelevant) 
|   │   |   ├── Benga1_843_1082_bboxes.json         # training image (name irrelevant) 
|   │   |   ├── Benga1_1189_1371_bboxes.json        # training image (name irrelevant)
│   |   |   └── ...                                 # etc.
|   │   ├── miniclips                               # miniclips used in experiments
│   |   |   └── ...                                 # this folder will be filled after the miniclip extraction (see instructions below)
|   │   ├── original                                # original video sequences
|   │   |   ├── Benga1_364_778.mp4                  # validation image (name irrelevant) 
|   │   |   ├── Benga1_843_1082.mp4                 # validation image (name irrelevant) 
|   │   |   ├── Benga1_1189_1371.mp4                # validation image (name irrelevant)
│   |   |   └── ...                                 # etc.
|   │   └──  labels.csv                             # file containing the behavior class label and id for each original sequence
│   └── ...                   
└── ...

Extract miniclips for experiments

To extract miniclips from ChimpBehave, run the following commands:

cd tools
python ./chimpbehave_extract_miniclips.py

Cross-validation

You can find all annotation files for stratified cross-validation in 'cross_validation_annotations' folder.

Using symlink (optional)

Note that if your dataset is stored in another location, you can use symlinks instead of duplicating it.

ln -s /path/to/chimpbehave/original/*.mp4 /home/<user>/ChimpBehave/

Reference

If you use this material, please cite it as below.

Fuchs, M., Genty, E., Bangerter, A., Zuberbühler, K., & Cotofrei, P. (2024). From Forest to Zoo: Great Ape Behavior Recognition with ChimpBehave. arXiv preprint arXiv:2405.20025.

@misc{fuchs2024chimpbehave,
      title={From Forest to Zoo: Great Ape Behavior Recognition with ChimpBehave}, 
      author={Michael Fuchs and Emilie Genty and Adrian Bangerter and Klaus Zuberbühler and Paul Cotofrei},
      year={2024},
      eprint={2405.20025},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}