guitarsounds 1.1.0

A python package to analyze and visualize harmonic sounds

guitarsounds

A python package to analyse guitar sounds. Developed as a lutherie research analysis tool with the Bruand Lutherie School. The guitarsound python package documentation is available at documentation.

Motivation

The main goal of this project is to provide a tool to efficiently analyse sound data from research projects in musical instrument desing. While sound analysis packages already exist, they are more directed to feature extraction for machine learning purposes. Additionnaly, some features of interest, like time dependent decay, onset shape and fourier transform peaks distribution are not computable trivially or acurately with existing tools. The current release of the guitarsounds package contains usual and advanced digital signal processing tools applied to the analysis of transient harmonic sounds with easy figure generation trough matplotlib. To allow the package functionalities to be used rapidly without learning the API, a graphic user interface is available based on jupyter lab widgets.

Installation

The following steps can be followed to use guitarsound interactively with Jupyter Notebook. A french version of the installation guide is available here.

• Download the Anaconda package management system link.

• Install the Anaconda package management system (Tutorial).

• Once Anaconda is installed, the guitarsound package needs to be installed. Without going into heavy details, the guitarsound package is not available from the Anaconda channels and needs to be installed using PIP, the Package Installer for Python. In order to install a package from PIP in Anaconda, you need to use the Anaconda Prompt :

To install guitarsound, type the following command into the Anaconda Prompt :

pip install guitarsounds

Once the installation of guitarsounds is finished, the package can be used in the Anaconda Jupyter Notebook environnement. The Jupyter Notebook environnement can be launched from Anaconda Navigator which is included in the Anaconda package management system.

Then, navigate to the sub-directory where you want your work to be and create a Jupyter Notebook :

The graphic user interface can be launched by typing the following code in a cell of the notebook :

import guitarsounds
interface = guitarsounds.Interface()

Pressing shift+enter runs the code in the cell and launches the graphic user interface of guitarsounds :

To go further, you may learn the guitarsounds API, see the API Tutorial notebook and the API documentation

Example usage

While extracting quantitative features from sounds allows for a meaningful analysis, listening to them remain an important part of the analysis. Soundfiles ca be loaded by creating a Sound class instance with the soundfile path as an argument

mysound = Sound('example_sounds/Wood_Guitar/Wood_E1.wav')

The Sound instance can then be conditionned to trim it right before its onset and filter the noise if needed:

mysound.condition()

The amplitude-time data of the Sound instance is stored in a Signal class and can be listened in a Jupyter Notebook:

Relevant time signal properties can then be rapidly extracted and visualized in the interactive Jupyter Notebook environment. For example, the time damping curve and the associated damping factor is a useful measure when measuring the effects of changes in the guitar design on the decay rate of different notes :

Two different sounds can also be compared using the SoundPack class, such as a tangible effect of a design change can be measured. Here we compare the fourier transform peaks of two guitars built using different materials :

The base API of the guitarsounds classes can also be leveraged to create custom signal analysis features. The following example shows the relatively straightforward implementation of the cumulative fast fourier transform metric from reference 1.

Thus guitarsounds allows both fast and interactive analysis of transient harmonic sounds as well as easily developping and testing new signal analysis features.

Community

Feel free to fork the guitarsound repository and submit pull requests implementing usefull changes. If you implement a new feature, please submit associated unit tests in your pull request. Pull requests which pass all the tests and propose changes aligned with the goal of this package should be accepted.

This project is maintained by the Bruand Lutherie School, if you have problems with the package or you need support in using it, please write an issue in this repository.