Ringo (version 1.36.0)

plotBM: Visualization of a binary matrix

Description

This function produces simple, heatmap-like visualizations of binary matrices.

Usage

plotBM(x, boxCol = "darkblue", reorder = FALSE, frame = TRUE, ...)

Arguments

x

Binary matrix to visualize

boxCol

Color to use for boxes of '1's

reorder

logical; states whether the rows shall be reordered according to the size of the category

frame

logical; states whether a frame should be drawn around the visualization. In contrast to the frame drawn in plot.default, there is no gap between the visualization and this frame.

...

further arguments passed on to plot.default

Value

The function invisibly returns the (reordered) matrix x, but its mainly called for its side effect of producing the visualization.

Details

For reordering, each row is interpreted as a binary matrix, for example a row z=(1,0,0,1) would be interpreted as the binary number 1001 = 9 in the decimal system. Rows are then reordered by the frequency of each binary number with the rows that correspond to the most frequent binary number shown at the top in the visualization.

See Also

polygon,colors

Examples

  A <- matrix(round(runif(80)), ncol=4, byrow=TRUE)
  dimnames(A)=list(letters[seq(nrow(A))],
                   as.character(as.roman(seq(ncol(A)))))
  show(A)
  plotBM(A, reorder=FALSE)
  plotBM(A, reorder=TRUE)