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

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

License

This project is licensed under the GNU GPLv3 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/