shape_histogram {playitbyr} | R Documentation |
Creates a histogram layer
shape_histogram(length = 5, tempo = 240, ..., data = NULL, mapping = NULL)
length |
The overall length, in seconds, of the histogram. |
tempo |
The tempo, in beats per minute; i.e. the rapidity with which to represent values from the dataset. |
... |
settings to pass to |
data |
The |
mapping |
A |
The audio histogram is implemented by a simple
frequency-modulation synthesis (through csound),
representing a univariate view of the data by rapidly
playing pitches that are samples from the dataset. Only
pitch
is intended to be used for mapping.
To compare groups, one can facet by the grouping variable
(see sonfacet
). All of the examples below
use this technique.
The remainder of the sound parameters (the same as those
used by shape_scatter
) are available for
setting to tweak aesthetics for the analyst's ear:
The starting time of the note (in seconds).
The pitch of the note, in the
Csound
oct
notation notation for pitches, where 8 is middle C and 1
represents an octave, to the corresponding frequency in
Hertz. By default this is scaled to the nearest musical
(chromatic) pitch. (See
scale_pitch_continuous
.)
The
duration of the note (relative to the total time if
relative = TRUE
, in seconds otherwise).
The volume of the note, as a proportion between 0 and 1, where 1 is the maximum volume. Note that a multiple notes that happen at the same time could add up to more than one, causing distortion and clipping.
The proportion of the note's length devoted to the initial (linear) attack.
The proportion of the note's length devoted to the (linear) decay.
The index of modulation. This affects
the distortion of the tone; indx = 0
is a sine
wave, whereas higher indices of modulation give
increasingly complex tones.
The modulating
frequency, given as a multiple of the primary frequency
(i.e. given by pitch
).
To set a sound parameter to a value, you simply
include it as an extra argument in shape_scatter
;
to map a parameter, you set the mapping for the
layer or the sonify
object using
sonaes
(see examples in
shape_scatter
).
A sonlayer
object that can be added onto a
sonify
object.
S. Ferguson, W. Martens and D. Cabrera, “Statistical Sonification for Exploratory Data Analysis”, in The Sonification Handbook, ed. Hermann, Hunt, Neuhoff. Available: http://sonification.de/handbook/
x1 <- sonify(iris, sonaes(pitch = Sepal.Length)) + sonfacet(Species) + shape_histogram(length = 3, tempo = 1800) ## Not run: x1 x2 <- sonify(iris, sonaes(pitch = Sepal.Length)) + sonfacet(Species) + shape_histogram(length = 5, tempo = 1800) # plays the same thing for longer ## Not run: x2 x3 <- sonify(iris, sonaes(pitch = Sepal.Length)) + sonfacet(Species) + shape_histogram(length = 3, tempo = 1200) # same length as original but fewer pitches ## Not run: x3