cellMap {cellWise}R Documentation

Draw a cellmap

Description

This function draws a cellmap, possibly of a subset of rows and columns of the data, and possibly combining cells into blocks. A cellmap shows which cells are missing and which ones are outlying, marking them in red for unusually large cell values and in blue for unusually low cell values. When cells are combined into blocks, the final color is the average of the colors in the individual cells.

Usage

cellMap(D, R, indcells = NULL, indrows = NULL,
                   standOD=NULL,showVals=NULL,rowlabels="",
                   columnlabels="",mTitle="", rowtitle="",
                   columntitle="",showrows=NULL, showcolumns=NULL,
                   nrowsinblock=1, ncolumnsinblock=1,autolabel=TRUE,
                   columnangle=90,sizetitles=1.1,adjustrowlabels=1,
                   adjustcolumnlabels=1, colContrast=1,outlyingGrad=TRUE,
                   darkestColor = sqrt(qchisq(0.999,1)),
                   drawCircles = TRUE)

Arguments

D

The data matrix (required input argument).

R

Matrix of standardized residuals of the cells (required input argument)

indcells

Indices of outlying cells. Defaults to NULL, which indicates the cells for which |\code{R}| > √(qchisq(0.99,1)).

indrows

Indices of outlying rows. By default no rows are indicated.

standOD

Standardized Orthogonal Distance of each row. Defaults to NULL, then no rows are indicated.

showVals

Takes the values "D", "R" or NULL and determines whether or not to show the entries of the data matrix (D) or the residuals (R) in the cellmap. Defaults to NULL, then no values are shown.

rowlabels

Labels of the rows.

columnlabels

Labels of the columns.

mTitle

Main title of the cellMap.

rowtitle

Title for the rows.

columntitle

Title for the columns.

showrows

Indices of the rows to be shown. Defaults to NULL which means all rows are shown.

showcolumns

Indices of the columns to be shown. Defaults to NULL which means all columns are shown.

nrowsinblock

How many rows are combined in a block. Defaults to 1.

ncolumnsinblock

How many columns are combined in a block. Defaults to 1.

autolabel

Automatically combines labels of cells in blocks. If FALSE, you must provide the final columnlabels and/or rowlabels. Defaults to TRUE.

columnangle

Angle of the column labels. Defaults to 90.

sizetitles

Size of row title and column title. Defaults to 1.1.

adjustrowlabels

Adjust row labels: 0=left, 0.5=centered, 1=right. Defaults to 1.

adjustcolumnlabels

Adjust column labels: 0=left, 0.5=centered, 1=right. Defaults to 1.

colContrast

Parameter regulating the contrast of colors, should be in [1,5]. Defaults to 1.

outlyingGrad

If TRUE, the color is gradually adjusted in function of the outlyingness. Defaults to TRUE.

darkestColor

Standardized residuals bigger than this will get the darkest color.

drawCircles

Whether or not to draw black circles indicating the outlying rows.

Author(s)

Rousseeuw P.J., Van den Bossche W.

References

Rousseeuw, P.J., Van den Bossche W. (2018). Detecting Deviating Data Cells. Technometrics, 60(2), 135-145. (link to open access pdf)

See Also

DDC

Examples

# For examples of the cellmap, we refer to the vignette:
vignette("DDC_examples")

[Package cellWise version 2.2.5 Index]