melodyplot: Plotting a melody

In tuneR: Analysis of Music and Speech

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.

tuneR documentation built on May 29, 2024, 11:28 a.m.