pitchMapping

Map a series of values into a series of pitches

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 

pitchMapping function

<dl><dt>x</dt>
<dd>Vector or data frame, series to be mapped</dd>
<dt>pitches</dt>
<dd>Vector of string, pitch scale (default: A minor pentatonic)</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

Pitch Mapping. — pitchMapping

<dl>

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


<dt>pitches</dt>
<dd>Vector of string, pitch scale (default: A minor pentatonic)</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>

pitchMapping: Pitch Mapping.

Description

Usage

Value

Arguments

Examples