genridge (version 0.7.0)

contourf: Enhanced Contour Plots

Description

This is an enhancement to contour, written as a wrapper for that function. It creates a contour plot, or adds contour lines to an existing plot, allowing the contours to be filled and returning the list of contour lines.

Usage

contourf(
  x = seq(0, 1, length.out = nrow(z)),
  y = seq(0, 1, length.out = ncol(z)),
  z,
  nlevels = 10,
  levels = pretty(zlim, nlevels),
  zlim = range(z, finite = TRUE),
  col = par("fg"),
  color.palette = colorRampPalette(c("white", col)),
  fill.col = color.palette(nlevels + 1),
  fill.alpha = 0.5,
  add = FALSE,
  ...
)

Value

Returns invisibly the list of contours lines, with components

levels, x, y. See

contourLines.

Arguments

x, y

locations of grid lines at which the values in z are measured. These must be in ascending order. By default, equally spaced values from 0 to 1 are used. If x is a list, its components x$x and x$y are used for x and y, respectively. If the list has component x$z this is used for z.

z

a matrix containing the values to be plotted (NAs are allowed). Note that x can be used instead of z for convenience.

nlevels

number of contour levels desired iff levels is not supplied

levels

numeric vector of levels at which to draw contour lines

zlim

z-limits for the plot. x-limits and y-limits can be passed through ...

col

color for the lines drawn

color.palette

a color palette function to be used to assign fill colors in the plot

fill.col

a call to the color.palette function or an an explicit set of colors to be used in the plot. Use fill.col=NULL to suppress the filled polygons. a vector of fill colors corresponding to levels. By default, a set of possibly transparent colors is calculated ranging from white to col, using transparency given by fill.alpha

fill.alpha

transparency value for fill.col, either a hex character string, or a numeric value between 0 and 1. Use fill.alpha=NA to suppress transparency.

add

logical. If TRUE, add to a current plot.

...

additional arguments passed to contour, including all arguments of contour.default not mentioned above, as well as additional graphical parameters passed by contour.default to more basic functions.

Author

Michael Friendly

See Also

contour, contourLines

contourplot from package lattice.

Examples

x <- 10*1:nrow(volcano)
y <- 10*1:ncol(volcano)
contourf(x,y,volcano, col="blue")
contourf(x,y,volcano, col="blue", nlevels=6)

# return value, unfilled, other graphic parameters
res <- contourf(x,y,volcano, col="blue", fill.col=NULL, lwd=2)
# levels used in the plot
sapply(res, function(x) x[[1]])