plotrix (version 3.8-4)

pie3D: Display a 3D pie chart

Description

Displays a 3D pie chart with optional labels.

Usage

pie3D(x,edges=NA,radius=1,height=0.1,theta=pi/6,start=0,border=par("fg"),
  col=NULL,labels=NULL,labelpos=NULL,labelcol=par("fg"),labelcex=1.5,
  sector.order=NULL,explode=0,shade=0.8,mar=c(4,4,4,4),pty="s",...)

Value

The bisecting angle of the sectors in radians.

Arguments

x

a numeric vector for which each value will be a sector

edges

the number of lines forming an ellipse

radius

the radius of the pie in user units

height

the height of the pie in user units

theta

The angle of viewing in radians

start

The angle at which to start drawing sectors.

border

The color of the sector border lines

col

The colors of the sectors

labels

Optional labels for each sector

labelpos

Optional positions for the labels (see examples)

labelcol

The color of the labels

labelcex

The character expansion factor for the labels

sector.order

Allows the operator to specify the order in which the sectors are drawn.

explode

The amount to "explode" the pie in user units

shade

If > 0 and < 1, the proportion to reduce the brightness of the sector color to get a better 3D effect.

mar

Margins around the pie.

pty

Whether to force a square plot region or not. (see Details)

...

graphical parameters passed to plot

Author

Jim Lemon

Details

pie3D scales the values in x so that they total 2*pi, dropping zeros and NAs. It then displays an empty plot, calculates the sequence for drawing the sectors and calls draw.tilted.sector to draw each sector. If labels are supplied, it will call pie3D.label to place these outside each sector. If supplied, the number of labels, label positions and sector colors must be at least equal to the number of values in x. If the labels are long, it may help to reduce the radius of the pie or change the position as in the example below.

In order to make the dimensions of the pie reasonably accurate, a square plot region (pty="s") is the default. If pty is set to "m", the user can change the margins, usually resulting in a non-square plot area. This will probably distort the pie somewhat.

See Also

pie3D.labels, draw.tilted.sector

Examples

 pieval<-c(2,4,6,8)
 pielabels<-
  c("We hate\n pies","We oppose\n  pies","We don't\n  care","We just love pies")
 # grab the radial positions of the labels
 lp<-pie3D(pieval,radius=0.9,labels=pielabels,explode=0.1,main="3D PIE OPINIONS")
 # lengthen the last label and move it to the left
 pielabels[4]<-"We cannot survive without our pies"
 lp[4]<-4.8
 # specify some new colors
 pie3D(pieval,radius=0.9,labels=pielabels,explode=0.1,main="3D PIE OPINIONS",
  col=c("brown","#ddaa00","pink","#dd00dd"),labelpos=lp)