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, 
    observedtype = "l", observedcol = "red", expectedcol = "grey", 
    gridcol = "grey", lwd = 2, las = 1, cex.axis = 0.9, 
    mar = c(5, 4, 4, 4) + 0.1, notenames = NULL, thin = 1, 
    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, type=observedtype, lwd=2, pch=15))

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. It can also be a matrix of k columns where those k notes in the same row are displayed at the same timepoint.
expected Expected notes (optional; in order to compare results), same format as observed.
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, where ylim must be an integer that represents the range of note heights that should be displayed.
observedtype Type (either "p" for points or "l" for lines) used for representing observed notes. "l" (the default) is not sensible for polyphonic representations.
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.
thin Amount of thinning of notenames, i.e. only each thinth notename is displayed on 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.tu-dortmund.de

See Also

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


[Package tuneR version 0.2-10 Index]