ringplot: ringplot

In ArtPoon/ggfree: ggplot2-style plots with base R graphics

ringplot

Description

ringplot generates a donut- or ring-plot to display the relative frequencies in a vector. If called with x- and y- coordinates, then the ringplot will be added to the current plot region, like calling points with add=TRUE. If 'vec' is a named vector, setting use.names=TRUE will add labels.

Usage

ringplot(
  vec,
  r0,
  r1,
  theta = pi/2,
  x = NA,
  y = NA,
  col = NA,
  use.names = F,
  offset = 1,
  srt = 0,
  cex.label = 0.8,
  ...
)

Arguments

vec:	a numeric vector containing data for plotting
r0:	radius to inner edge of ring. If set to 0, ringplot produces the dreaded piechart.
r1:	radius to outer edge of ring
theta:	angle of first segment in radians (fraction of 2pi). Essentially rotates the ringplot.
x:	x-coordinate of origin. Defaults to NA for new plot.
y:	y-coordinate of origin. Defaults to NA for new plot.
col:	vector of colours for filling segments. Defaults to RColorBrewer::brewer.pal(n=10, name="Set3")
use.names:	if vec is a named vector, display labels
offset:	radius adjustment of labels relative to origin
srt:	string rotation for labels
cex.label:	character expansion for labels
...:	additional arguments for plot() if new

Examples

require(RColorBrewer)
pal1 <- brewer.pal(5, 'Blues')
pal2 <- brewer.pal(5, 'Reds')

# nested ring-plots
ringplot(VADeaths[,1], r0=0.3, r1=0.6, col=pal1)
ringplot(VADeaths[,2], x=0, y=0, r0=0.6, r1=0.9, col=pal2, 
use.names=T, offset=0.05, srt=90)
text(x=0, y=0, adj=0.5, label='VADeaths', cex=0.8)

ArtPoon/ggfree documentation built on July 11, 2024, 11:15 a.m.