loudnessMapping

Map a series of values into a series of loudnesses

A set of tools to facilitate data sonification and handle the 'musicXML' format <https://usermanuals.musicxml.com/MusicXML/Content/XS-MusicXML.htm>.
Several classes are defined for basic musical objects such as note pitch, note duration, note, measure and score.
Moreover, sonification utilities functions are provided, e.g. to map data into musical attributes such as pitch, loudness or duration.
A typical sonification workflow hence looks like: get data; map them to musical attributes; create and write the 'musicXML' score,
which can then be further processed using specialized music software (e.g. 'MuseScore', 'GuitarPro', etc.).
Examples can be found in the blog <https://globxblog.github.io/>, the presentation by Renard and Le Bescond (2022, <https://hal.science/hal-03710340v1>) or the poster by Renard et al. (2023, <https://hal.inrae.fr/hal-04388845v1>).

Benjamin Renard

musicXML

Data Sonification using 'musicXML'

INRAE 

European Commission 

loudnessMapping function

<dl><dt>x</dt>
<dd>Vector or data frame, series to be mapped</dd>
<dt>lMin</dt>
<dd>Integer, minimum loudness (default corresponds to ppp)</dd>
<dt>lMax</dt>
<dd>Integer, maximum loudness (default corresponds to fff)</dd>
<dt>qtrans</dt>
<dd>function, quantile transformation to be applied before mapping
For instance data can be "normalized" by using qnorm.</dd>
<dt>...</dt>
<dd>further arguments to be passed to qtrans.</dd></dl>

Arguments

Loudness Mapping. — loudnessMapping

<dl>

<dt>x</dt>
<dd>Vector or data frame, series to be mapped</dd>


<dt>lMin</dt>
<dd>Integer, minimum loudness (default corresponds to ppp)</dd>


<dt>lMax</dt>
<dd>Integer, maximum loudness (default corresponds to fff)</dd>


<dt>qtrans</dt>
<dd>function, quantile transformation to be applied before mapping
For instance data can be "normalized" by using qnorm.</dd>


<dt>...</dt>
<dd>further arguments to be passed to qtrans.</dd>

</dl>

loudnessMapping: Loudness Mapping.

Description

Usage

Value

Arguments

Examples