| quantplot {tuneR} | R Documentation |
Plot an observed melody and (optional) an expected melody, as well as corresponding energy values (corresponding to the loudness of the sound) within a quantization grid.
quantplot(observed, energy = NULL, expected = NULL, bars,
barseg = round(length(observed) / bars),
main = NULL, xlab = NULL, ylab = "note", xlim = NULL, ylim = NULL,
observedcol = "red", expectedcol = "grey", gridcol = "grey",
lwd = 2, las = 1, cex.axis = 0.9, mar = c(5, 4, 4, 4) + 0.1,
notenames = NULL, silence = "silence", plotenergy = TRUE, ...,
axispar = list(ax1 = list(side=1), ax2 = list(side=2), ax4 = list(side=4)),
boxpar = list(),
energylabel = list(text="energy", side=4, line=2.5, at=rg.s-0.25, las=3),
energypar = list(pch = 20),
expectedpar = list(),
gridpar = list(gridbar = list(col = 1), gridinner = list(col=gridcol)),
observedpar = list(col = observedcol, pch = 15))
observed |
Either a vector of observed notes resulting from some quantization,
or a list with components notes (observed notes) and energy (corresponding energy values),
e.g. the result from a call to quantize. |
energy |
A vector of energy values with same quantization as observed
(overwrites any given energy values, if observed is a list). |
expected |
Expected notes (optional; in order to compare results). |
bars |
Number of bars to be plotted (e.g. corresponding to quantize arguments). |
barseg |
Number of segments (minimal length notes) in each bar. |
main |
Main title of the plot. |
xlab, ylab |
Annotation of x/y-axes. |
xlim, ylim |
Range of x/y-axis. |
observedcol |
Colour for the observed notes. |
expectedcol |
Colour for the expected notes. |
gridcol |
Colour of the inner-bar grid. |
lwd |
Line width, see par for details. |
las |
Orientation of axis labels, see par for details. |
cex.axis |
Size of tick mark labels, see par for details. |
mar |
Margins of the plot, see par for details. |
notenames |
Optionally specify other notenames (character) for the y axis. |
silence |
Character string for label of the ‘silence’ (default) axis. |
plotenergy |
Logical indicating whether to plot energy values in the bottom part of the plot;
default is TRUE), if energy values are specified, and FALSE otherwise. |
... |
Additional graphical parameters to be passed to underlying plot function. |
axispar |
A named list of three other lists (ax1,ax2, and ax4)
containing parameters passed to the corresponding axis calls for the three axis
time (ax1), notes (ax2), and energy (ax4). |
boxpar |
A list of parameters to be passed to the box generating functions. |
energylabel |
A list of parameters to be passed to the energy-label
generating mtext call. |
energypar |
A list of parameters to be passed to the points function
that draws the energy values. |
expectedpar |
A list of parameters to be passed to the rect
function that draws the rectangles for expected values. |
gridpar |
A named list of two other lists (gridbar and gridinner)
containing parameters passed to the abline functions that draw the grid lines
(for bar separators and inner bar (note) separators). |
observedpar |
A list of parameters to be passed to the lines
function that draws the observed values. |
Uwe Ligges, ligges@statistik.tu-dortmund.de
noteFromFF, FF, melodyplot, quantize;
for an example, see the help in tuneR.