duration

Creates a new instance of a 'duration' object

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 

duration function

<dl><dt>type</dt>
<dd>Integer in 2^(0:6), note type (longest 1=whole, shortest 64=64th).
1 = whole, 2 = half, 4 = quarter, 8 = eighth, etc. down to 64 = 64th</dd>
<dt>dot</dt>
<dd>Logical, is note dotted?</dd>
<dt>triplet</dt>
<dd>Logical, is note triplet? (play 3 for 2)</dd>
<dt>mxlDivision</dt>
<dd>Positive integer, musicXML "division" defining the
time resolution, i.e. the shortest possible note.
It is expressed as a fraction of a quarter note.
The value of 96 allows allows using 64th notes and their triplet/dotted versions.</dd>
<dt>mxlDuration</dt>
<dd>Positive integer, music XML "duration" expressed in
number of mxlDivision's. In general, mxlDivision/mxlDuration should not be modified.</dd></dl>

Arguments

duration constructor. — duration

<dl>

<dt>type</dt>
<dd>Integer in 2^(0:6), note type (longest 1=whole, shortest 64=64th).
1 = whole, 2 = half, 4 = quarter, 8 = eighth, etc. down to 64 = 64th</dd>


<dt>dot</dt>
<dd>Logical, is note dotted?</dd>


<dt>triplet</dt>
<dd>Logical, is note triplet? (play 3 for 2)</dd>


<dt>mxlDivision</dt>
<dd>Positive integer, musicXML "division" defining the
time resolution, i.e. the shortest possible note.
It is expressed as a fraction of a quarter note.
The value of 96 allows allows using 64th notes and their triplet/dotted versions.</dd>


<dt>mxlDuration</dt>
<dd>Positive integer, music XML "duration" expressed in
number of mxlDivision's. In general, mxlDivision/mxlDuration should not be modified.</dd>

</dl>

duration: duration constructor.

Description

Usage

Value

Arguments

Examples