A table object, or either a vector or a list of several
categorical vectors containing grouping variables for the first
(x) margin of the plotted matrix.
y
Vector or list of vectors for grouping variables for the
second (y) dimension of the plotted matrix.
z
Vector of values for the size of the dots in the plotted matrix.
xlab
Text label for the x dimension. This will be displayed on the
x axis and in the plot title.
ylab
Text label for the y dimension. This will be displayed on the
y axis and in the plot title.
zlab
Text label for the dot size. This will be included in the
plot title.
dotsize
Maximum dot size. You may need to adjust this value
for different plot devices and layouts.
dotchar
Plotting symbol or character used for dots. See the help
page for the points function for symbol codes.
dotcolor
Scalar or vector specifying the color(s) of the dots in
the plot.
text.size, text.color
Character size and color for row and
column headers
main
Plot title text.
label
Boolean flag indicating whether the actual value of the
elements should be shown on the plot.
label.digits
Number of digits used in formatting value labels.
label.size, label.color
Character size and color for value labels.
scale.method
Method of scaling the sizes of the dot, either
"volume" or "diameter". See below.
scale.range
Method for scaling original data to compute
circle diameter. scale.range="absolute" scales the data
relative to 0 (i.e, maps [0,max(z)] –> [0,1]), while
scale.range="relative" scales the data relative to min(z)
(i.e. maps [min(z), max(z)] –> [0,1]).
rowsrt, colsrt
Angle of rotation for row and column labels.
rowmar, colmar
Space allocated for row and column labels. Each
unit is the width/height of one cell in the table.
show.zeros
boolean. If FALSE, entries containing zero will be left
blank in the plotted matrix. If TRUE, zeros will be
displayed.
show.margins
boolean. If TRUE, row and column sums are
printed in the bottom and right margins, respectively.
cum.margins
boolean. If TRUE, marginal fractions are
graphically presented in grey behind the row/column label area.
sorted
boolean. If TRUE, the rows will be
arranged in sorted order by using the levels of the first y factor,
then the second y factor, etc. The same process is used for the
columns, based on the x factors
label.lines
boolean. If TRUE, borders will be drawn for
row and column level headers.
hide.duplicates
boolean. If TRUE, column and row headers
will omit duplicates within row/column to reduce clutter. Defaults
to TRUE.
fun
function to be used to combine data elements with the same
levels of the grouping variables x and y. Defaults to sum
...
Additional arguments passed to balloonplot.default
or plot, as appropriate.
Details
This function plots a visual matrix. In each x,y cell a
dot is plotted which reflects the relative size of the corresponding
value of z. When scale.method="volume" the volume of
the dot is proportional to the relative size of z. When
scale.method="diameter", the diameter of the dot is proportional to
the the relative size of z. The "volume" method is default
because the "diameter" method visually exaggerates differences.
Value
Nothing of interest.
Note
z is expected to be non-negative. The function will still
operate correctly if there are negative values of z, but the
corresponding dots will have 0 size and a warning will be generated.