piechart                package:base                R Documentation

Pie Charts

Description:

     Draw a pie chart.

Usage:

     piechart(x, labels = names(x), edges = 200, radius = 0.8,
              density = NULL, angle = 45, col = NULL,
              main = NULL, ...)

Arguments:

       x: a vector of positive quantities. The values in `x' are
          displayed as the areas of pie slices.

  labels: a vector of character strings giving names for the slices.

   edges: the circular outline of the pie is approximated by a polygon
          with this many edges.

  radius: the pie is drawn centered in a square box whose sides range
          from -1 to 1.  If the character strings labeling the slices
          are long it may be necessary to use a smaller radius.

 density: the density of shading lines, in lines per inch. The default
          value of `NULL' means that no shading lines are drawn.
          Non-positive values of `density' also inhibit the drawing of
          shading lines.

   angle: the slope of shading lines, given as an angle in degrees
          (counter-clockwise).

     col: a vector of colors to be used in filling the slices. If
          missing `par("bg")' is used, unless `density' is specified
          when `par("fg")' is used.

    main: an overall title for the plot.

     ...: graphical parameters can be given as arguments to `piechart'.

Note:

     Pie charts are a very bad way of displaying information. The eye
     is good at judging linear measures and bad at judging relative
     areas.

     A bar chart or dot chart is a preferable way of displaying this
     type of data.

See Also:

     `dotchart'.

Examples:

     piechart(rep(1,24), col=rainbow(24), radius=0.9)

     pie.sales <- c(0.12, 0.3, 0.26, 0.16, 0.04, 0.12)
     names(pie.sales) <- c("Blueberry", "Cherry",
         "Apple", "Boston Cream", "Other", "Vanilla Cream")
     piechart(pie.sales,
         col=c("purple", "violetred1", "green3",
         "cornsilk", "cyan", "white"))
     piechart(pie.sales,
         col=gray(seq(0.4,1.0,length=6)))
     piechart(pie.sales,
         density=10, angle=15+10*1:6)

