Welcome to the STRAUSS documentation!

Strauss is a python toolkit for data “sonification” - the representation of data using sound - with both scientific and outreach applications.

The code aims to make rich and evocative sonification straightforward, with a number of presets and examples enabling a quick start. At the same time, it is intended to be flexible enough to allow high level of control over the sonification and various expressive elements of sound and harmony if required. The project is described in more detail in the paper Introducing STRAUSS: a flexible sonification Python package, presented at the 28th Proceedings of the International Community of Auditory Displays (2023). You can read about the associated Audio Universe project here for examples of using Strauss for a variety of applications.

Strauss is packaged with a variety of example scripts. These mostly follow a parameter mapping approach, but also other approaches, for example a spectral audification approach in the Spectral Data example.

Note

Strauss and its documentation is in continuous development, with more features in the pipeline. Follow the GitHub repository for the cutting-edge release.

• Motiviation & Background
  • Why sonification?
  • Strauss approach
  • References
• Getting Started
  • Installation
  • Text-to-speech
  • Example jupyter notebooks/scripts
  • Running some examples
• Elements of a Strauss Sonification
  • Source Class
  • Score Class
  • Generator Class
  • Channels Class
  • Sonification Class
• Parameter Reference
  • Synthesiser Generator
  • Spectraliser Generator
  • Sampler Generator
• Detailed Documentation
  • User-Facing Modules
  • Ancillary Modules
• Examples
  • Audio Caption (AudioCaption.ipynb)
  • Day Sequence (DaySequence.ipynb)
  • Earth System (EarthSystem.ipynb)
  • Light Curve Soundfonts (LightCurveSoundfonts.ipynb)
  • Planetary Orbits (PlanetaryOrbits.ipynb)
  • Sonifying Data 1D (SonifyingData1D.ipynb)
  • Spectral Data (SpectralData.ipynb)
  • Stars Appearing (StarsAppearing.ipynb)
• To-do List

Indices and tables

• Index

• Module Index

• Search Page