Skip to content

Using convolutional neural networks to build and train a bird species classifier on bird song data with corresponding species labels.

License

Notifications You must be signed in to change notification settings

johnmartinsson/bird-species-classification

Repository files navigation

DISCLAIMER

This repository is not actively maintained. It is the result of a master's thesis and the code has been made available as a reference if anyone would like to reproduce the results of the thesis.

Bird Species Classification

These are the project files for a master's thesis carried out at Chalmers University of Technology. The aim of the project was to improve upon a state-of-the-art bird species classifier by using deep residual neural networks, multiple-width frequency-delta data augmentation, and meta-data fusion to build and train a bird species classifier on bird song data with corresponding species labels.

Please cite the master's thesis if this repository is useful for your research.

Setup

$ git clone https://github.com/johnmartinsson/bird-species-classification
$ virtualenv -p /usr/bin/python3.6 venv
$ source venv/bin/activate
(venv)$ pip install -r requirements.txt

# Ubuntu/Linux 64-bit, CPU only, Python 3.6
(venv)$ pip install --upgrade tensorflow
# Ubuntu/Linux 64-bit, GPU enabled, Python 3.6
# Requires CUDA toolkit 8.0 and CuDNN v5. For other versions, see "Install from sources" below.
(venv)$ pip install --upgrade tensorflow-gpu

Usage Instructions

This section explains how to preprocess the birdCLEF2016 dataset, how to split the data set in to a training and validation set, how to train a model on the training data, and how to evaluate the model on the validation data.

Preprocess

First we need to down-sample the sound recordings.

$ # Resample to 22050 Hz (stand in wav directory)
$ for i in *; do sox $i -r 22050 tmp.wav; mv tmp.wav $i; done

Secondly, the signal parts, and the noise parts of the recordings are extracted and split into three second segments. The signal segments are put in different directories depending on the class given in the xml data, and all noise segments are put in a separate noise directory.

$ python preprocess_birdclef.py --xml_dir=<path-to-xml-dir> \
                                --wav_dir=<path-to-wav-dir> \
                                --output_dir=<path-to-output-dir>

Lastly, the data is split into a training set and a validation set:

$ python create_dataset.py --src_dir=<path-to-signal-dir> \
                           --dst_dir=<path-to-destination-dir> \
                           --subset_size=<subset-size> \
                           --valid_percentage=<validation-percentage>

where src points to the signal segments, dst is the destination, subset size is an optional argument which makes training and validation data a randomly chosen subset of bird species from the whole data set, and the valid percentage is how many percent of the data that should be in the validation set.

Train

$ python train.py --config_file=conf.ini

Run Predictions

$ python run_predictions.py --experiment_path=<path-to-experiment>

Evaluation

$ python evaluate.py --experiment_path=<path-to-results>

Models

In this project two different models have been used: a reimplementation of Elias Sprengels winning solution for the BirdCLEF 2016 challenge, and a Keras implementation of the deep residual neural network.

Libraries

The following libraries are used in this method:

Evaluation Methods

Challenges

This is a collection of bird species classification challenges that, has been, and are carried out around the world.

BirdCLEF: an audio record-based bird identification task

Solutions and Source Code

Bird Audio Detection Challenge

MLSP 2013 Bird Classification Challenge

Solutions and Source Code

Original compilation source: xuewei4d

Applications

This is a collection of applications which solve a similar problem.

Warbler

About

Using convolutional neural networks to build and train a bird species classifier on bird song data with corresponding species labels.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published