circleTile: Add circles to a tile plot

In chrisadolph/tileForShiny: Plot multiple graphical displays in a tiled layout with automated or customizable titles, axes, and annotations

Description

Initializes a trace which plots circles to a tile graphic. Useful for making bubbleplots with known circle areas.

Usage

circleTile(...)

Arguments

...

Any number of arguments given below. Must include exactly one horizontal dimension (x or top), exactly one vertical dimension (y or right), and should include a vector of radii r. All inputs should be identified by appropriate tags; i.e., use circleTile(x=myxvar, y=myyvar, r=myradii), not circleTile(myxvar,myyvar,myradii)

Details

This function does no plotting; instead, it creates a circleTile object, or trace of plotting data, to be drawn on one or more plots in a tiled arrangement of plots. To complete the drawing include the object as an input to tile. From tile, it is possible to set further options including plot and axis titles, axis ranges and labels, logged axes, and annotations to the plot.

circleTile simply adds a circle at a specific location or locations to a tile plot. It serves as the tile equivalent to the grid graphics function circleGrob, and is primarily useful for annotating plots which also use other traces or for constructing bubble plots. Note that circleTile traces must be created in advance and included in the call to tile, rather than added afterward.

To plot symbols to a location outside the plotting area, users might try combining clip="off", with coordinates placing the symbols in the desired spot.

Value

A circleTile object, used only as an input to tile.

circleTile-specific parameters

A call to pointsTile must provide an orthogonal pair of the following inputs:

x

coordinate vector of circles to plot, attached to the x axis.

y

coordinate vector of circles to plot, attached to the y axis.

top

coordinate vector of circles to plot, attached to the top axis.

right

coordinate vector of circles to plot, attached to the right axis.

r

radius vector of plotted circles.

Users will often wish to provide the following input:

plot

scalar or vector, the plot(s) in which this trace will be drawn; defaulting to the first plot. Plots are numbered consecutively from the top left, row-by-row. Thus in a 2 x 3 tiling, the first plot in the second row is plot number 4.

In addition to these circleTile-specific parameters, users may provide any of the generic tile parameters documented in pointsTile.

Author(s)

Christopher Adolph [e-mail]

See Also

tile, pointsTile, scatter

chrisadolph/tileForShiny documentation built on Feb. 6, 2022, 12:34 a.m.