The mapproject function is used to project
the x and y coordinates when proj != "none".
If multiple images are to be plotted (i.e., if z is an array),
then the main argument can be a vector with length matching
dim(z)[3], and each successive element of the vector will
be used to add a title to each successive image plotted.
See the Examples.
Additionally, if common.legend = FALSE, then separate limits
for the z-axis of each image can be provided as a list.
Specifically, if dim(z)[3] == k, then zlim should
be a list of length k, and each element of the list should
be a 2-dimensional vector providing the lower and upper limit,
respectively, of the legend for each image. Alternatively, if
zlim is a list of length k, then common.legend
is set to FALSE.
The range of zlim is cut into \(n\) partitions,
where n is the length of col.
It is generally desirable to increase lratio when
more images are plotted simultaneously.
The multiple plots are constructed using the
autolayout function, which
is incompatible with the mfrow and mfcol arguments
in the par function and is also
incompatible with the split.screen function.
The mtext.args argument can be passed through ...
in order to customize the outer title. This should be a named
list with components matching the arguments of
mtext.
Lines can be added to each image by passing the lines
argument through .... In that case, lines should be
a list with components x and y specifying the
locations to draw the lines. The appearance of the plotted lines
can be customized by passing a named list called lines.args
through .... The components of lines.args should match
the arguments of lines. See Examples.
Points can be added to each image by passing the points
argument through .... In that case, points should be
a list with components x and y specifying the
locations to draw the points. The appearance of the plotted points
can be customized by passing a named list called points.args
through .... The components of points.args should match
the components of points. See Examples.
Text can be added to each image by passing the text
argument through .... In that case, text should be
a list with components x and y specifying the
locations to draw the text, and labels, a component
specifying the actual text to write. The appearance of the plotted text
can be customized by passing a named list called text.args
through .... The components of text.args should match
the components of text. See Examples.
The legend scale can be modified by passing legend.axis.args
through .... The argument should be a named list
corresponding to the arguments of the axis
function. See Examples.
The image axes can be modified by passing axis.args
through .... The argument should be a named list
corresponding to the arguments of the axis
function. The exception to this is that arguments xat
and yat can be specified (instead of at) to specify
the location of the x and y ticks. If xat or yat
are specified, then this overrides the xaxt and yaxt
arguments, respectively. See the paxes
function to see how axis.args can be used.
The legend margin can be customized by passing legend.mar
to pimage through .... This should be a numeric
vector indicating the margins of the legend, identical to how
par("mar") is specified.
The various options of the labeling, axes, and legend are largely
independent. e.g., passing col.axis through ...
will not affect the axis unless it is passed as part of the
named list axis.args. However, one can set the various
par options prior to plotting to simultaneously
affect the appearance of multiple aspects of the plot. See
Examples for pimage. After plotting,
reset.par() can be used to reset
the graphics device options to their default values.