tableplot: Tableplot
In friendly/tableplot: Represents tables as semi-graphic displays

Description Usage Arguments Value Author(s) References See Also Examples

A tableplot (Kwan, 2008) is designed as a semi-graphic display in the form of a table with numeric values, but supplemented by symbols with size proportional to cell value(s), and with other visual attributes (shape, color fill, background fill, etc.) that can be used to encode other information essential to direct visual understanding. Three-way arrays, where the last dimension corresponds to levels of a factor for which the first two dimensions are to be compared are handled by superimposing symbols.

tableplot(values, ...)

## Default S3 method:
tableplot(values, assign.sets, cell.specs, 
	v.parts = 0, h.parts = 0, gap = 2, text.m = 0, empty.text.size = 0.8, empty.text.col = "grey30", 
	title = NULL, table.label = TRUE, label.size = 0.8, side.rot = 0, left.space = 10, top.space = 10+10*(!is.null(title)), ...)

`values`	A matrix or 3-dimensional array of values to be displayed in a tableplot
`...`	Arguments passed down to `tableplot.default`
`assign.sets`	Matrix of specification assignments, of the same size as the first two dimensions of `values`. Entries refer to the sub-lists of `cell.specs`. Defaults to `matrix(1, dim(values)[1], dim(values)[2]))`.
`cell.specs`	List of lists; each list is one specification for the arguments to `cellgram`. `cell.specs[[k]]` is used for all table cells where `assign.sets[i,j] = k`. See `make.specs` for a simple way to construct the `cell.specs` argument.
`v.parts`	An integer vector giving the number of columns in two or more partititions of the table. If provided, sum must equal number of columns.
`h.parts`	An integer vector giving the number of rows in two or more partititions of the table. If provided, sum must equal number of columns.
`gap`	Width of the gap in each partition, if partitions are requested by `v.parts` and/or `h.parts`
`text.m`	Matrix of text for insertion into text-only, empty cell(s)
`empty.text.size`	Text size for text-only cells
`empty.text.col`	Text color for text-only cells
`title`	Main title
`table.label`	Logical value: whether to print row/column labels.
`label.size`	Character size for labels
`side.rot`	Degree of rotation (positive for counter-clockwise)
`left.space`	Space between left of tableplot and left edge of drawing region, in mm.
`top.space`	Space between top of tableplot and top edge of drawing region, in mm.

None. Used for its side effect

Ernest Kwan

Kwan, E. (2008). Improving Factor Analysis in Psychology: Innovations Based on the Null Hypothesis Significance Testing Controversy. Ph. D. thesis, York University.

Kwan, E. and Lu, I. R. R. and Friendly, M. (2009). Tableplot: A new tool for assessing precise predictions Zeitschrift fÃ¼r Psychologie / Journal of Psychology, 217, 38-48.

cellgram, make.specs

# Factor pattern matrix from Nisenbaum etal. (2004)
Nisenbaum <- matrix(c(
 93,  14, -14,  -3,
 87,  17, -13, -12,
 39, -15,  15,  29,
 25,  10,  21,  41,
 36, -10,   8,  35,
  5,  79,  -1,   0,
 10,  72, -11,  16,
  8,  80,  12,  -7,
 23,  47,   6,   8,
-28,  27,   5,  78,
  6,  33, -22,  37,
-10,  21, -10,  68,
-19,  -1,  93,  11,
-11,  -8,  86,   3,
  2,  -1,  53,   3,
 10,  27,  51, -11,
 21,  28,  50, -12,
 18,  10,  11,  23,
  0,  25,  15,  20,
 15, -24,   8,  54,
-13,  31,  14,  20), 21, 4, byrow=TRUE)
colnames(Nisenbaum) = paste("F", 1:4, sep="")

tableplot(
	values = Nisenbaum,
	cell.specs = list(list(0,"grey50",1,0,"red",1,"white","grey80",1,0.7,"black",FALSE,"black",93)),
	assign.sets = matrix(1,21,4)
	)