Skip to main content

GUANO, the "Grand Unified" bat acoustics metadata format

Project description

This is the Python reference implementation for GUANO, the "Grand Unified
Acoustic Notation Ontology", a metadata format for bat acoustics recordings.

It includes a simple Python module with support for reading and writing
GUANO metadata.

The actual preliminary GUANO specification can be found at
[doc/guano_specification.md](doc/guano_specification.md).


Requirements
============

- Python 2.7


Installation
============

Download and install magically from the Python Package Index::

$> pip install -U guano

In addition to having the `guano` Python module available for use in your own
software, you'll also have a small collection of [useful scripts](bin/) to use.


Alternately, you can check out the project from GitHub and install locally in
developer mode to hack on it yourself::

$> git clone https://github.com/riggsd/guano-py.git
$> cd guano-py
$> python setup.py develop


API Usage
=========

```python
from guano import GuanoFile

f = GuanoFile('test.wav')

print f['GUANO|Version']
>>> 1.0

print f['Make'], f['Model']
>>> 'Pettersson', 'D500X'

print f['PET', 'GAIN']
>>> 80

f['Species Manual ID'] = 'Myso'

f['Note'] = 'I love GUANO!'

f.write()
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

guano-0.0.4.tar.gz (13.4 kB view hashes)

Uploaded Source

Built Distribution

guano-0.0.4-py2-none-any.whl (9.6 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page