pykanto

A python library for animal vocalisation analysis

https://github.com/nilomr/pykanto

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 5 DOI reference(s) in README
  • Academic publication links
    Links to: arxiv.org, springer.com, zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

A python library for animal vocalisation analysis

Basic Info
Statistics
  • Stars: 37
  • Watchers: 4
  • Forks: 3
  • Open Issues: 15
  • Releases: 10
Created over 6 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

README.md



pykanto logo



version PyPI status license Open Source Love Python 3.8

pykanto is a python library to manage and analyse bird vocalisations

InstallationGetting startedAcknowledgements

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.

webapp


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:

Article
DOI


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

Owner

  • Name: Nilo
  • Login: nilomr
  • Kind: user
  • Location: Oxford, UK
  • Company: Edward Grey Institute, Department of Zoology

PhD student @OxfordUniversity working on bird song learning and cultural evolution.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Merino Recalde"
  given-names: "Nilo"
  orcid: "https://orcid.org/0000-0003-3903-1288"
title: "pykanto-example"
version: 0.1.7
doi: 10.5281/zenodo.7941355
date-released: 2023-05-02
url: "https://github.com/nilomr/pykanto"

GitHub Events

Total
  • Create event: 1
  • Release event: 3
  • Issues event: 4
  • Watch event: 8
  • Issue comment event: 13
  • Push event: 8
Last Year
  • Create event: 1
  • Release event: 3
  • Issues event: 4
  • Watch event: 8
  • Issue comment event: 13
  • Push event: 8

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 30
  • Total pull requests: 8
  • Average time to close issues: 18 days
  • Average time to close pull requests: 1 day
  • Total issue authors: 7
  • Total pull request authors: 2
  • Average comments per issue: 1.67
  • Average comments per pull request: 0.38
  • Merged pull requests: 8
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 3
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 2
  • Pull request authors: 0
  • Average comments per issue: 2.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • nilomr (11)
  • gg4u (7)
  • ArKornreich (3)
  • athenasyarifa (2)
  • saguileran (2)
  • WalidERRAIS (2)
  • advaymishra2003 (1)
  • masonyoungblood (1)
Pull Request Authors
  • nilomr (7)
  • WalidERRAIS (1)
Top Labels
Issue Labels
type: enhancement (7) type: bug (6) type: question (3) type: user help (3) priority: high (2) status: completed (2) type: discussion (2) status: pending (1) status: in progress (1) priority: medium (1) type: refactor (1) type: docs (1) priority: low (1) good first issue (1)
Pull Request Labels
status: review needed (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 28 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 10
  • Total maintainers: 1
pypi.org: pykanto

A library for managing and analysing animal vocalisation data.

  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 28 Last month
Rankings
Dependent packages count: 10.1%
Stargazers count: 14.3%
Average: 18.7%
Dependent repos count: 21.6%
Forks count: 22.7%
Downloads: 24.7%
Maintainers (1)
Last synced: 10 months ago