A python library for analysing and visualising soundscape assessments.
Project description
Soundscapy
A python library for analysing and visualising soundscape assessments.
Disclaimer: This module is still heavily in development, and might break what you're working on. It will also likely require a decent amount of troubleshooting at this stage. I promise bug fixes and cleaning up is coming!
Installation
The package is still under development, but can be installed with pip:
pip install soundscapy
Examples
We are currently working on writing more comprehensive examples and documentation, please bear with us in the meantime.
An example notebook which reproduces the figures used in our recent paper "How to analyse and represent quantitative soundscape data" is provided in the examples
folder.
Acknowledgements
The newly added Binaural analysis functionality relies directly on three acoustic analysis libraries:
- python-acoustics for the standard environmental and building acoustics metrics,
- scikit-maad for the bioacoustics and ecological soundscape metrics, and
- MoSQITo for the psychoacoustics metrics. We thank each of these packages for their great work in making advanced acoustic analysis more accessible.
Citation
If you are using Soundscapy in your research, please help our scientific visibility by citing our work! Please include a citation to our accompanying paper:
Mitchell, A., Aletta, F., & Kang, J. (2022). How to analyse and represent quantitative soundscape data. JASA Express Letters, 2, 37201. https://doi.org/10.1121/10.0009794
Development Plans
As noted, this package is in heavy development to make it more useable, more stable, and to add features and improvements. At this stage it is mostly limited to doing basic quality checks of soundscape survey data and creating the soundscape distribution plots. Some planned improvements are:
- Simplify the plotting options
- Possibly improve how the plots and data are handled - a more OOP approach would be good.
- Add appropriate tests and documentation.
- Bug fixes,
particularly around setting color palettes.
Large planned feature additions are:
- Add better methods for cleaning datasets, including robust outlier exclusion and imputation.
- Add handling of .wav files.
- Integrate environmental acoustic and psychoacoustic batch processing. This will involve using existing packages (e.g. MoSQito, python-acoustics) to do the metric calculations, but adding useful functionality for processing many files at once, tieing them to a specific survey response, and implementing a configuration file for maintaining consistent analysis settings.
- Integrate the predictive modelling results from the SSID team's research to enable a single pipelined from recording -> psychoacoustics -> predicted soundscape perception (this is very much a pie-in-the-sky future plan, which may not be possible).
Contributing
If you would like to contribute or if you have any bugs you have found while using `Soundscapy', please feel free to get in touch or submit an issue or pull request!
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 soundscapy-0.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e5033aa06ad77d736c07c7826ea4d0011b3a46779699327a51e2a9aac4353146 |
|
MD5 | 45503437ec5c426bbdfaec8459410a1e |
|
BLAKE2b-256 | 5005daa65ebdeb0d2e3f10251048343e0b49c9a1966085c91b464932c5611c46 |