Signal Plot

DESCRIPTION:

Function to plot a signal. This is the method for the plot function for class signalSeries, and it can also be called directly.

USAGE:

plot.signalSeries(x, ..., main=x@title, ylab=x@units[1],  
                  xlab=x@units.position, top.ticks=F, right.ticks=F,  
                  reference.grid=T,  
                  merge.args=list(pos="union", how="interp"), 
                  x.axis.args=list(), y.axis.args=list(),  
                  plot.args=list(), log.axes="c", complex.convert=Mod, 
                  dB=F, frame=sys.nframe()) 

REQUIRED ARGUMENTS:

x
a univariate or multivariate signal object or a list of signal objects.

OPTIONAL ARGUMENTS:

...
additional signal objects can be passed as unnamed arguments immediately following the x argument. These signals will also be plotted. You can also pass in additional plotting arguments such as xlim and other par parameters.
main
main title for the plot.
ylab
y-axis title for the plot (note that only the first element is used).
xlab
x-axis title for the plot.
top.ticks
if TRUE, tick marks are placed on the top axis as well as the bottom axis.
right.ticks
if TRUE, tick marks are placed on the right axis as well as the left axis.
reference.grid
if TRUE, a reference grid is superposed on the plot.
merge.args
a list of parameters to pass to the seriesMerge function for merging signals passed through x and ... into a single signal object.
x.axis.args
a list of parameters to pass to the axis.numeric function for customizing the x-axis.
y.axis.args
a list of parameters to pass to the axis.numeric function for customizing the y-axis.
plot.args
a list of parameters to pass to the plot function lines.render.
log.axes
set to "xy", "x", or "y" to make the corresponding axis or axes logarithmic. Any other value makes them linear.
complex.convert
function used to convert complex numbers to real for plotting.
dB
if TRUE, makes a dB plot (y values are converted to dB by taking 10 * log10(Mod(y))).
frame
the frame in which to parse the ... arguments. This argument can be used when plot.timeSeries is called from within another function if the plot titles are not coming out correctly.

VALUE:

the output of axis.numeric for the x-axis, for compatibility with plot.timeSeries.

SIDE EFFECTS:

A plot will be produced on the active device. It will look nicer if a Trellis plotting device is used. To control the layout of the axes and reference grid lines, as well as other style parameters, use the functions trellis.par.get and trellis.par.set.

SEE ALSO:

, , , , .

EXAMPLES:

# plot the speech data set 
plot(say.wavelet) 
# plot part of the data set using both lines and points 
plot(say.wavelet[2500:2600,], plot.args=list(type="b", pch="*"))