Skip to content

Image title Image title

Welcome to Soundscapy

PyPI version Documentation Status License

Soundscapy is a Python library for analysing and visualising soundscape assessments. This package was designed to (1) load and process soundscape assessment data, (2) visualise the data, and (3) enable psychoacoustic analysis of soundscape recordings.

Note

This project is still under development. We're working hard to make it as good as possible, but there may be bugs or missing features. If you find any issues, please let us know by submitting an issue on Github.

Getting Started

To get started with Soundscapy, you'll need to install it first. You can do this by running the following command:

pip install soundscapy

Optional Dependencies

Soundscapy splits its functionality into optional modules to reduce the number of dependencies required for basic functionality. By default, Soundscapy includes the survey data processing and plotting functionality. If you would like to use the binaural audio processing and psychoacoustics functionality, you will need to install the optional audio dependency:

pip install "soundscapy[audio]"

Documentation

This documentation is designed to help you understand and use Soundscapy effectively. It's divided into several sections:

  • Tutorials: Practical examples showing how to use our project in real-world scenarios.
  • API Reference: Detailed information about our project's API.
  • News: Change log and updates.

Contributing

We welcome contributions from the community. If you're interested in contributing, please get in touch or submit an issue on Github.

Citing Soundscapy

Note

If you use Soundscapy in your research, 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](https://doi.org/10.1121/10.0009794) <!-- markdownlint-disable MD046 -->

License

This project is licensed under the BSD 3-Clause License. For more information, please see the license.md file.

Project layout

mkdocs.yml     # The configuration file.
docs/
    index.md   # The documentation homepage.
    about.md   # The about page.
    license.md # The license page.
    tutorials/ # Tutorial pages.
        Introduction to SSM Analysis.ipynb
    ...        # Other markdown pages, images and other files.
src/soundscapy/