melodyplot {tuneR}

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 -/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 [e-mail]

See Also

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