pykanto

pykanto is a python library to manage and analyse bird vocalisations

Installation • Getting started • Acknowledgements

ㅤ

Installation

See installing pykanto for a complete installation guide.

To install pykanto using pip, simply run:

pip install pykanto

Getting started

See getting started for a complete use guide.

Datasets

There are three small vocalisation datasets packaged with pykanto, used for unit tests and demonstration purposes. These will be downloaded automatically when you install the library.

Dataset	Description	Source
Great tit songs	Dawn songs from male birds in a population in Oxford, UK	Nilo M. Recalde
European storm-petrel purr songs	Males singing from burrows in the Shetland and Faroe islands	XC46092 © Dougie Preston XC663885 © Simon S. Christiansen // CC licence
Bengalese finch songs	Recordings from two isolated Bengalese finches	Originally published in Tachibana, Koumura & Okanoya (2015) Data: DOI

License

The project is licensed under the MIT license.

Citation

If you use pykanto in your own work, please cite the associated article and/or the repository:

Acknowledgements

• Some of the methods that are part of pykanto are directly inspired by or adapted from Sainburg, Thielk and Gentner (2020). I have indicated where this is the case in the relevant method's docstring.

• The dereverberate function is based on code by Robert Lachlan that is part of Luscinia, a powerful software for bioacoustic archiving, measurement and analysis.

• I have learnt a lot about packaging and python by perusing the structure of projects by NickleDave. I became aware of VocalPy, a project that aims to "develop an ecosystem of interoperable packages" for "computational vocal communication and learning research" when I had already written most of pykanto, but eventually I'd like to make it compatible with it: standardisation is direly needed in the field and I don't want to contribute to the chaos.

ㅤ

_{© Nilo M. Recalde, 2021-present}