Python wrapper to Tadarida-D software
Project description
PyTadarida
PyTadarida is a Python wrapper for the Tadarida-D algorithm, which is a method for detecting presence of bioacoustic events in audio recordings. The algorithm is described in detail in the following paper:
Bas, Y., Bas, D., & Julien, J.-F. (2017). Tadarida: A Toolbox for Animal Detection on Acoustic Recordings. Journal of Open Research Software, 5(1), 6. DOI: http://doi.org/10.5334/jors.154
The original implementation of the algorithm is written in C++, and is available on its GitHub repository.
Installation
PyTadarida only runs in Linux. Make sure you have all the Tadarida-D dependencies:
sudo apt-get install libfftw3-dev libicu-dev libsndfile1-dev libqt5core5a
PyTadarida is available on PyPI, and can be installed with pip:
pip install pytadarida
Usage
PyTadarida exposes a single function, run_tadarida
, which takes a list of .wav
files or directories containing .wav files as input, and returns a pandas
DataFrame containing the detected events.
from pytadarida import run_tadarida
events, status = run_tadarida(["/path/to/file.wav", "/path/to/directory"])
The status
variable is a object containing the status of the algorithm after
running. It can be used to check whether the algorithm was able to process the
file, and any warnings that were generated.
tadarida_run_message = status.stdout
tadarida_error_message = status.errors
tadarida_detection_message = status.detect
License
As the original Tadarida-D algorithm is licensed under the GNU General Public License v3.0, PyTadarida is also licensed under the GNU General Public License v3.0. This means that PyTadarida is free software, and you are free to use, modify, and redistribute it under certain conditions. See the LICENSE file for more information.
Contributing
Contributions are welcome! If you find a bug, or have a feature request, please open an issue on the GitHub repository
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pytadarida-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 07209dcaf95ad62ccd37dfde9bb1f568393490493decc00b177e66d83c857587 |
|
MD5 | be6af9ae24110235db0ed39ab9203740 |
|
BLAKE2b-256 | 734a3bf95bc942286cdc1e5c98c3f143e07c4a2856b050dc2fec0c5bf030ddcc |