plot.imlist: Plot a List of Images

Description

Plots an array of pixel images.

Usage

# S3 method for imlist
plot(x, …, plotcommand="image",
                          equal.ribbon=FALSE, ribmar=NULL)
  # S3 method for imlist
image(x, …, equal.ribbon=FALSE, ribmar=NULL)
  # S3 method for listof
image(x, …, equal.ribbon=FALSE, ribmar=NULL)

Arguments

An object of the class "imlist" representing a list of pixel images. Alternatively x may belong to the outdated class "listof".

…

Arguments passed to plot.solist to control the spatial arrangement of panels, and arguments passed to plot.im to control the display of each panel.

equal.ribbon

Logical. If TRUE, the colour maps of all the images will be the same. If FALSE, the colour map of each image is adjusted to the range of values of that image.

ribmar

Numeric vector of length 4 specifying the margins around the colour ribbon, if equal.ribbon=TRUE. Entries in the vector give the margin at the bottom, left, top, and right respectively, as a multiple of the height of a line of text.

plotcommand

Character string giving the name of a function to be used to display each image. Recognised by plot.imlist only.

Value

Null.

Details

These are methods for the generic plot commands plot and image for the class "imlist". They are currently identical.

An object of class "imlist" represents a list of pixel images. (The outdated class "listof" is also handled.)

Each entry in the list x will be displayed as a pixel image, in an array of panels laid out on the same graphics display, using plot.solist. Individual panels are plotted by plot.im.

If equal.ribbon=FALSE (the default), the images are rendered using different colour maps, which are displayed as colour ribbons beside each image. If equal.ribbon=TRUE, the images are rendered using the same colour map, and a single colour ribbon will be displayed at the right side of the array. The colour maps and the placement of the colour ribbons are controlled by arguments … passed to plot.im.

Examples

Run this code

# NOT RUN {
 ## bei.extra is a list of pixel images
 Y <- solapply(bei.extra, scaletointerval)
 image(Y, equal.ribbon=TRUE, main="", col.ticks="red", col.axis="red")
# }