Skip to content

BioAcoustic Inference, an easy tool to annotate your audio files of animal sounds using very few manual annotation as little as one.

Notifications You must be signed in to change notification settings

brain-bzh/BioAcousticInference

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BioAcoustic Inference

Authors: Ilyass Moummad, Romain Serizel, Nicolas Farrugia

BioAcoustic Inference provides an easy to use Python code to predict occurences of an animal sound of interest using only few annotations of an audio recording.

The code and the pretrained model is from our ICASSP 2024 work "Regularized Contrastive Learning for Few-shot Bioacoustic Sound Event Detection", Code here, and weights here (you don't have to download them in advance, they will be automatically downloaded from the code).

Installation

pip install -r requirements.txt

Usage

Have a 'txt' annotation file with few annotations (as little as one) with the same name as the audio file and launch the following code (replace audio_path with the corresponding name):

python3 inference.py --audiopath audio_path

Optionally you can specify where to download the model weights using --ckpt, per default it is model/bioacoustics_model.pth

This code will create a new 'txt' file (with '_inference' as a suffix) with the inferred annotations.


Cite

@INPROCEEDINGS{10446409,
  author={Moummad, Ilyass and Farrugia, Nicolas and Serizel, Romain},
  booktitle={ICASSP 2024 - 2024 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP)}, 
  title={Regularized Contrastive Pre-Training for Few-Shot Bioacoustic Sound Detection}, 
  year={2024},
  volume={},
  number={},
  pages={1436-1440},
  keywords={Training;Event detection;Animals;Speech coding;Self-supervised learning;Signal processing;Feature extraction;Supervised contrastive learning;total coding rate;transfer learning;few-shot learning;bioacoustics;sound event detection},
  doi={10.1109/ICASSP48485.2024.10446409}}

About

BioAcoustic Inference, an easy tool to annotate your audio files of animal sounds using very few manual annotation as little as one.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%