melodyplot {tuneR}R Documentation

Plotting a melody

Description

Plot a observed melody and (optional) an expected melody, as well as corresponding energy values (corresponding to the loudness of the sound).

Usage

melodyplot(object, observed, expected = NULL, bars = NULL, 
    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(), 
    expectedpar = list(),
    gridpar = list(col = gridcol), 
    observedpar = list(col = observedcol, lwd = 2))

Arguments

object An object of class Wspec.
observed Observed notes, probably as a result from noteFromFF (or a smoothed version). This should correspond to the Wspec object.
expected Expected notes (optional; in order to compare results).
bars Number of bars to be plotted (a virtual static segmentation takes place). If NULL (default), time rather than bars are used.
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 melody.
expectedcol Colour for the expected melody.
gridcol Colour of the 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 (default: TRUE), whether to plot energy values in the bottom part of the plot.
... 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 lines function that draws the energy curve.
expectedpar A list of parameters to be passed to the rect function that draws the rectangles for expected values.
gridpar A list of parameters to be passed to the abline function that draws the grid lines.
observedpar A list of parameters to be passed to the lines function that draws the observed values.

Author(s)

Uwe Ligges, ligges@statistik.uni-dortmund.de

See Also

noteFromFF, FF, quantplot; for an example, see the help in tuneR.


[Package tuneR version 0.2-1 Index]