# KABR: Kenyan Animal Behavior Recognition from Drone Videos

## Facts

- Provider: Imageomics Institute (Kholiavchenko et al.)
- License: CC0-1.0 (https://huggingface.co/datasets/imageomics/KABR/raw/main/README.md)
- Size: 45 files
- Format: JSON, CSV (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/imageomics/KABR
- Access: public, readable without an account
- DOI: https://doi.org/10.57967/hf/1010
- Category: Life Sciences
- Source: https://openaccess.thecvf.com/content/WACV2024W/CV4Smalls/papers/Kholiavchenko_KABR_In-Situ_Dataset_for_Kenyan_Animal_Behavior_Recognition_From_Drone_WACVW_2024_paper.pdf
- Page: https://scigantic.com/archive/a5a996f9-8c1a-54ef-8ba9-3368932c0547
- Keywords: Life Sciences, JSON, CSV, Hugging Face

## About

Drone video of Kenyan wildlife annotated for animal behavior recognition, covering giraffes, plains zebras and Grevy's zebras filmed at the Mpala Research Centre in January 2023. More than 10 hours of footage at 5472 by 3078 pixels and 29.97 frames per second were labelled by a team of 10 overseen by an expert zoologist, with eight classes: walk, trot, run, graze, browse, head up, auto-groom and occluded. Animals were detected with YOLOv8 and tracked with SORT, and 400 by 300 pixel mini-scenes centred on each animal were cut out to reduce the effect of drone motion. The dataset holds 1,139,893 frames: 488,638 of Grevy's zebras, 492,507 of plains zebras and 158,748 of giraffes. Listing the repository (measured 2026-11-13) shows KABR/ with annotation/ (train and val CSV files and class distribution), configs/ and dataset/image/, where image sequences are stored as 2 GB zip parts per species with MD5 files, plus download.py; about 233 GB in the repository. Concatenate the parts and unzip (or run download.py, which needs about 116 GB free), then read frames with OpenCV or PIL; image2video.py rebuilds clips. Benchmarks with I3D, SlowFast and X3D are reported. Released under CC0-1.0; citation of the WACV 2024 workshop paper is requested.

## Load the data

```python
import pandas as pd
df = pd.read_csv("hf://datasets/imageomics/KABR/KABR/annotation/train.csv")
df.head()
```

## Data structure

File types in sampled files: JSON, CSV

Example file: `KABR/annotation/train.csv`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/a5a996f9-8c1a-54ef-8ba9-3368932c0547
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/a5a996f9-8c1a-54ef-8ba9-3368932c0547
- Over MCP: `get_schema_card` with id `a5a996f9-8c1a-54ef-8ba9-3368932c0547` at https://api.scigantic.com/mcp

## Related topics

- [JSON datasets](https://scigantic.com/topics/json)
- [CSV datasets](https://scigantic.com/topics/csv)
- [Life Sciences datasets](https://scigantic.com/topics/life-sciences)
