Skip to content
A pre-trained deep learning system for detecting bird flight calls in continuous recordings
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
birdvoxdetect
docs
tests
.gitignore
.travis.yml remove py27 from Travis YAML Jul 3, 2019
LICENSE Initial commit Oct 16, 2018
README.md
conda-bvd-v02.yaml
conda-bvd03py36.yaml
conda-jubvd-v02.yaml upload conda-jubvd-v02.yaml Jul 2, 2019
setup.cfg bugfix setup.cfg Nov 15, 2018
setup.py Bump tensorflow from 1.12.0 to 1.12.2 Oct 29, 2019

README.md

BirdVoxDetect: robust sound event detection of bird flight calls

An open-source Python library and command-line tool for automatically detecting bird flight calls in audio recordings.

PyPI MIT license Coverage Status Build Status Documentation Status

BirdVoxDetect is a pre-trained deep learning system for detecting bird flight calls in continuous audio recordings. It relies on per-channel energy normalization (PCEN) and context-adaptive convolutional neural network (CA-CNN) for improved robustness to background noise. It is made available both as a Python library and as a command-line tool for Windows, OS X, and Linux.

For details about the deep learning model in BirdVoxDetect and how it was trained, we refer the reader to:

Robust Sound Event Detection in Bioacoustic Sensor Networks
Vincent Lostanlen, Justin Salamon, Andrew Farnsworth, Steve Kelling, and Juan Pablo Bello
PLoS ONE 14(10): e0214168, 2019. DOI: https://doi.org/10.1371/journal.pone.0214168

Installation instructions

Dependencies

TensorFlow

Because TensorFlow comes in CPU-only and GPU-enabled variants, we leave it up to the user to install the version that best fits their use case.

On most platforms, either of the following commands should properly install TensorFlow:

pip install tensorflow # CPU-only version
pip install tensorflow-gpu # GPU-enabled version

For more detailed information, please consult the installation instructions of TensorFlow.

libsndfile (Linux only)

BirdVoxDetect depends on the PySoundFile module to load audio files, which itself depends on the non-Python library libsndfile. On Windows and Mac OS X, these will be installed automatically via the pip package manager and you can therefore skip this step. However, on Linux, libsndfile must be installed manually via your platform's package manager. For Debian-based distributions (such as Ubuntu), this can be done by simply running

apt-get install libsndfile

For more detailed information, please consult the installation instructions of pysoundfile.

Installing BirdVoxDetect

The simplest way to install BirdVoxDetect is by using pip, which will also install the additional required dependencies if needed.

To install the latest version of BirdVoxDetect from source:

  1. Clone or pull the latest version:

     git clone git@github.com:BirdVox/birdvoxdetect.git
    
  2. Install using pip to handle Python dependencies:

     cd birdvoxdetect
     pip install -e .
    

Acknowledging BirdVoxDetect

Please cite the following paper when using BirdVoxDetect in your work:

Robust Sound Event Detection in Bioacoustic Sensor Networks
Vincent Lostanlen, Justin Salamon, Andrew Farnsworth, Steve Kelling, and Juan Pablo Bello
PLoS ONE 14(10): e0214168, 2019. DOI: https://doi.org/10.1371/journal.pone.0214168

You can’t perform that action at this time.