plotrix (version 2.1-5)

color2D.matplot: Display a numeric matrix as color matrix

Description

Display the values of a numeric 2D matrix or data frame as colored rectangles.

Usage

color2D.matplot(x,redrange=c(0,1),greenrange=c(0,1),bluerange=c(0,1),
  show.legend=FALSE,xlab="Column",ylab="Row",do.hex=FALSE,...)

Arguments

x

data values

redrange, greenrange, bluerange

the ranges of red, green and blue that will be scaled to represent the range of numeric values

show.legend

whether to display a color range rectangle with the extreme numeric values in the lower left corner of the plot

xlab,ylab

axis labels for the plot.

do.hex

plot packed hexagons instead of rectangles.

...

arguments passed to plot.

Value

• nil

Details

Displays a plot with the same number of rectangular cells as there are numeric values in the matrix or data frame. Each rectangle is colored to represent its corresponding value. The rectangles are arranged in the conventional display of a 2D matrix with rows beginning at the top and columns at the left. The color scale defaults to black for the minimum value and white for the maximum. If hexagonal cells are requested, the user may have to adjust the plot device dimensions to get regular hexagons, especially when the matrix is not square.

See Also

color.scale, image

Examples

x<-matrix(rnorm(1024)+sin(seq(0,2*pi,length=1024)),nrow=32)
 if(dev.interactive()) par(ask=TRUE)
 color2D.matplot(x,c(1,0),c(0,0),c(0,1),show.legend=TRUE,
  xlab="Columns",ylab="Rows",main="2D matrix plot")
 # now do hexagons
 color2D.matplot(x,c(1,0),c(0,0),c(0,1),show.legend=TRUE,
  xlab="Columns",ylab="Rows",do.hex=TRUE,main="2D matrix plot (hexagons)")
 par(ask=FALSE)