playitbyr Getting Started Support--Help, Bugs, and Documentation GitHub Sonification Resources

scale_attkp_continuous {playitbyr}R Documentation

Continuous scales for note attacks


These shortcut functions (with the notation scale_[sound parameter]_[scaling function]) are intended to be added onto a sonify object to specify how [data parameter] from the data (a column of the data) is to be mapped to sonic parameters (here, "attkp", the sharpness of a note's initial attack).


  scale_attkp_continuous(soundlimits, limits = NULL,
    by = NULL, ...)

  scale_attkp_exp(soundlimits, limits = NULL, by = NULL,



Other parameters (currently ignored)


The limits of the sound parameter.


The limits of the data to train, a numeric vector of length 2. All data values outside these limits are returned as NA. If NULL, the default, the function takes the minimum and maximum of the data


The unit to round the sound parameter to.


In shape_scatter, there are 3 phases of a note: the attack (the initial fade-in of the note), sustain (where the note is held), and the decay (the final fade-out of the note. attkp is the percentage of the note devoted to the attack; so a note with attkp = 0.01 would have a very quick start of the note, whereas a note with attkp = 0.5 would gradually fade in.

_continuous scales are a linear scaling, whereas _exp is an exponential scale.


A sonscaling object, to be used in sonify or added onto a sonify object.

See Also

shape_scatter, which has more information about this parameter