README.md

easybird

         

---

Easybird is python toolkit for Bird Activity Detection (BAD).

Setup and Install

We recommend using conda for environment management, since we use conda-forge to install an essential library libsndfile. To setup, copy the following command to your terminal.

conda create -n bird
conda activate bird
conda install -c conda-forge libsndfile -y

After setup the virtual env, install with pip.

pip install easybird

Single Wav

Identify bird activities for single waveform.

from easybird import detection

hasBird, confidence = detection.from_wav('bird.wav', noise_thres=0.5, device='cpu') # device=option('cuda','cpu')

Output

print(hasBird)
>>> True
print(confidence)
>>> 0.9996312260627747

Multiple Wavs

Identify bird activities for multiple wavforms.

from easybird import detection

results = detection.from_wavs(['bird1.wav','bird2.wav','bird3.wav'], noise_thres=0.5, device='cpu')

Output

print(results)
>>> [(bird1, True, 0.99963122), (bird2, False, 0.37834975), (bird3, True, 0.87340939)]