Skip to main content

A program for detecting chimpanzee drumming in long-term rainforest recordings

Project description

Chimpanzee Drumming Detector

This is a python program for detecting chimpanzee drumming in long-term rainforest recordings.

The associated publication can be read at:

This program only contains the test pipeline, not the training pipeline.


Either install the latest stable release from PyPI

pip install ChimpDrummingDetector

Alternatively, you can install this package through to code on this repository. Simply download this repository as a zip, and then do:

cd path/to/downloaded/zip
cd ChimpDrummingDetector
pip install ChimpDrummingDetector


In your python code, do

import chimp_detector

path_to_wave_to_analyze = path/to/wave.wav 
detection_result = chimp_detector.detect_drumming(path_to_wave_to_analyze)
  • Input: A wave file. Might be mono or stereo
  • Output: A pandas dataframe with following columns
    • timepoints_in_seconds [float]: The analyzed timepoints
    • drumming_probability [float]: Probability of chimpanzee drumming in range [0,1] for the respective timepoint
    • drumming_binarized [boolean]: Binarization of probability with threshold 0.5, where TRUE means "there is drumming in this frame".


This Packages requires:

  • Python version 3.8
  • librosa==0.8.0
  • tensorflow==2.3.1
  • pandas==1.1.2
  • numpy==1.18.5


Please cite this paper in your publication if you use this program for your research.

  title={Compensating class imbalance for acoustic chimpanzee detection with convolutional recurrent neural networks},
  author={Anders, Franz and Kalan, Ammie K and K{\"u}hl, Hjalmar S and Fuchs, Mirco},
  journal={Ecological Informatics},

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ChimpDrummingDetector-0.0.3.tar.gz (3.3 MB view hashes)

Uploaded Source

Built Distribution

ChimpDrummingDetector-0.0.3-py3-none-any.whl (3.3 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page