Skip to content
/ koe Public

Koe: open-source software to visualise, segment and classify acoustic units in animal vocalisations

koe.io.ac.nz

License

GPL-3.0 license
39 stars 12 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

fzyukio/koe

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

719 Commits
assets
assets
 
 
docs
docs
 
 
koe
koe
 
 
notebooks
notebooks
 
 
root
root
 
 
settings
settings
 
 
templates
templates
 
 
tests
tests
 
 
.agignore
.agignore
 
 
.babelrc
.babelrc
 
 
.bandit
.bandit
 
 
.bootstraprc
.bootstraprc
 
 
.coveragerc
.coveragerc
 
 
.dockerignore
.dockerignore
 
 
.editorconfig
.editorconfig
 
 
.eslintignore
.eslintignore
 
 
.eslintrc.js
.eslintrc.js
 
 
.gitignore
.gitignore
 
 
.gitlab-ci.yml
.gitlab-ci.yml
 
 
.isort.cfg
.isort.cfg
 
 
.pre-commit-config.yaml
.pre-commit-config.yaml
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
Dockerfile-basic
Dockerfile-basic
 
 
Dockerfile-tensorflow
Dockerfile-tensorflow
 
 
LICENCE.md
LICENCE.md
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
build.js
build.js
 
 
deploy-hot.sh
deploy-hot.sh
 
 
deploy.sh
deploy.sh
 
 
docker-compose.yml
docker-compose.yml
 
 
initial.zip
initial.zip
 
 
install-redis.sh
install-redis.sh
 
 
jupyter_notebook_config.py
jupyter_notebook_config.py
 
 
maintenance.py
maintenance.py
 
 
manage.py
manage.py
 
 
matplotlibrc
matplotlibrc
 
 
package-docker.sh
package-docker.sh
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
poetry-install.py
poetry-install.py
 
 
poetry.lock
poetry.lock
 
 
post-deploy.sh
post-deploy.sh
 
 
pyproject.toml
pyproject.toml
 
 
requirements-basic.txt
requirements-basic.txt
 
 
requirements-conda-forge.txt
requirements-conda-forge.txt
 
 
requirements-dev.txt
requirements-dev.txt
 
 
requirements-production.txt
requirements-production.txt
 
 
requirements-tensorflow.txt
requirements-tensorflow.txt
 
 
requirements.txt
requirements.txt
 
 
ruff.toml
ruff.toml
 
 
run_koe_app.sh
run_koe_app.sh
 
 
runtime.txt
runtime.txt
 
 
semantic.json
semantic.json
 
 
server.js
server.js
 
 
setup-ubuntu.sh
setup-ubuntu.sh
 
 
sync.sh
sync.sh
 
 
webpack.base.config.js
webpack.base.config.js
 
 
webpack.local.config.js
webpack.local.config.js
 
 
webpack.prod.config.js
webpack.prod.config.js
 
 
yarn.lock
yarn.lock
 
 

Repository files navigation

Koe: open-source software to visualise, segment and classify acoustic units in animal vocalisations

What is it?

Koe is an application for classifying and analysing animal vocalisations. Koe offers bulk-labelling of units via interactive ordination plots, as well as visualisation and playback, segmentation, measurement, data filtering/exporting and new tools for analysing repertoire and sequence structure -- all in an integrated database.

Koe's unit table is designed for classifying, annotating and filtering units. Each unit row contains a spectrogram which becomes enlarged during mouse-over. Unit audio plays when a spectrogram is clicked. The table can be sorted/filtered by any columns. Sorting by the Similarity Index column arranges units by spectral similarity for expedited labelling. Example data are New Zealand bellbird Anthornis melanura song units.

Segment songs into units view, showing a song being segmented into units. The interface for partitioning recordings into songs is similar. Units are manually segmented by dragging over the spectrogram; unit endpoints can be re-adjusted at any time. A selection box can be clicked for playback. Spectrogram zoom, contrast and colourmap can be adjusted. Units can be labelled, or comments given. This example is a female New Zealand bellbird (Anthornis melanura) song from Hauturu.

Koe's interactive ordination view allows the user to encircle groups of points on the plot with the lasso tool, to view their spectrograms and hear their audio. Mousing over a point in a selection highlights the corresponding spectrogram in the left-hand panel. Selections can be labelled in bulk directly on the plot or opened as a unit table to view detailed unit information. The user can zoom, toggle the visibility of classes, and export the plot as a vector graphic. This example shows a t-SNE ordination of 7189 units of male and female New Zealand bellbird Anthornis melanura song on Tiritiri Matangi Island.

How to install, run and deploy this on your own?

I recommend using the official website at https://koe.io.ac.nz. However if you want to run Koe on your own computer/server, here's how:

Install

Run

Upgrade

Deploy

Licence

License: GPL v3

This work is distrbuted under GPL version 3.0 licence.

Read the full LICENCE here

Contact us if you want a different licence option.

Copyright

Copyright (c) 2013-9999 Yukio Fukuzawa. All rights reserved.

About

Koe: open-source software to visualise, segment and classify acoustic units in animal vocalisations

koe.io.ac.nz

Resources

Readme

License

GPL-3.0 license

Code of conduct

Code of conduct
Activity

Stars

39 stars

Watchers

8 watching

Forks

12 forks
Report repository

Releases 3

April 2021 Release Latest
Mar 28, 2021
+ 2 releases

Packages

No packages published

Contributors 5

Languages