plot.symbolmap: Plot a Graphics Symbol Map

Description

Plot a representation of a graphics symbol map, similar to a plot legend.

Usage

# S3 method for symbolmap
plot(x, …, main, xlim = NULL, ylim = NULL,
                         vertical = FALSE,
                         side = c("bottom", "left", "top", "right"),
                         annotate = TRUE, labelmap = NULL, add = FALSE,
                         nsymbols = NULL)

Arguments

Graphics symbol map (object of class "symbolmap").

…

Additional graphics arguments passed to points, symbols or axis.

main

Main title for the plot. A character string.

xlim,ylim

Coordinate limits for the plot. Numeric vectors of length 2.

vertical

Logical. Whether to plot the symbol map in a vertical orientation.

side

Character string specifying the position of the text that annotates the symbols.

annotate

Logical. Whether to annotate the symbols with labels.

labelmap

Transformation of the labels. A function or a scale factor which will be applied to the data values corresponding to the plotted symbols.

add

Logical value indicating whether to add the plot to the current plot (add=TRUE) or to initialise a new plot.

nsymbols

Optional. The number of symbols that should be displayed. (This may not be exactly obeyed.)

Value

None.

Details

A graphics symbol map is an association between data values and graphical symbols.

This command plots the graphics symbol map itself, in the style of a plot legend.

Examples

Run this code

# NOT RUN {
  g <- symbolmap(inputs=letters[1:10], pch=11:20)
  plot(g)

  g2 <- symbolmap(range=c(-1,1),
                    shape=function(x) ifelse(x > 0, "circles", "squares"),
                    size=function(x) sqrt(ifelse(x > 0, x/pi, -x)),
                    bg = function(x) ifelse(abs(x) < 1, "red", "black"))
  plot(g2, vertical=TRUE, side="left", col.axis="blue", cex.axis=2)
# }