sonoUno

Data sonorization tool


License
MIT
Install
pip install sonoUno==3.1.0

Documentation

SonoUno Software

Description

SonoUno is a sonification software for astronomical data presented on a table (txt or csv files). The software is being developed based on the study of other software (Sonification Sandbox, MathTrax and xSonify) and standards of accessibility like the ISO 9241-171:2008 (Guidance on software accessibility). In order to develop the first approach of a graphical user interface, we perform a theoretical framework based on bibliography of user cases, focused on blind and visual impairment people.

The develop language is Python and we use modular design, in order to do collaborative work. The sonoUno now is multiplatform, tested on windows 10, Ubuntu (16.04 and 18.04), CentOS 7 and Mac (Mojave and Catalina); the development team work continuously to maintain this benefit. The principal goal of the SonoUno is to allow the user to open data files (txt or csv extension), show the plot and sonify the data. At the moment, the sonification is perform by variation of pitch and the sonification settings allow to change the volume and the timbre.

Additionally, SonoUno allow to select a specific range of data on the ‘x’ axis, mark and save point of interest in the data, apply predefined mathematical functions (for example, logarithm and square) and manipulate the data arrays with an Octave interface. In the section settings, the user can configure the plot and some features of the sound.

Finally, the software allows the user to save the plot, a text file with the points marked on the data and a csv file with the plotted data.

Installation

  1. Install octave

For Mac you can use brew: brew install octave
For Ubuntu: sudo apt install octave
For Centos: yum install epel-release\ yum install octave
For Windows download the installer from: https://ftpmirror.gnu.org/octave/windows/octave-5.2.0_1-w64-installer.exe . Once is installed you have to set the environment variables.

  1. Check that you have python 3.x installed on your system running ‘python3’ or ‘python’ on a terminal. If you don’t have python:

For Mac: brew install python3
For Ubuntu: sudo apt install --upgrade python3
For Centos7:
To install python3 without interfear with python2:sudo yum install centos-release-scl\ sudo yum install rh-python36
To enable python3: scl enable rh-python36 bash
For Windows download the installer from: https://www.python.org/ftp/python/3.8.1/python-3.8.1-amd64.exe\

Note: from here we use python3, you have to use python or python3 depending on the step before.

  1. Check that pip is installed with ‘python3 -m pip -V’. If not:

For Mac, pip is installed with python installation.
For Ubuntu: sudo apt install python3-pip
For Centos, pip is installed with python installation.
For Windows, pip is installed with the executable.

  1. Only for Linux you have to install some other packages:
    Ubuntu: sudo apt install libsdl2-mixer-2.0-0 libsdl2-image-2.0-0 libsdl2-2.0-0 libsdl-ttf2.0-0 libgtk-3-dev
    For ubuntu-16.04:
    python3 -m pip install -U -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-16.04 wxPython
    For ubuntu-18.04:
    python3 -m pip install -U -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-18.04 wxPython
    Centos: yum install SDL
    pip install -U -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/centos-7 wxPython

  2. If you want to download the software from the repository install git, if not you can use the version on Pypi.

Opening the software

From Pypi (only Linux and Mac)

Install with pip:
python3 -m pip install sonoUno

To open the sonoUno software:
sonouno

From github

Download from the webpage: https://github.com/sonoUnoTeam/sonoUno . Go to Downloads and unzip the file.

The other option is to clone the git repository from the terminal with:
git clone https://github.com/sonoUnoTeam/sonoUno.git

Then, on the terminal, go to the folder which contain the setup.py and install it:
python3 -m pip install .

To open the sonoUno software:
cd sonoUno
python3 sonoUno