\Header{piechart}{Pie Charts}
\keyword{hplot}{piechart}
\begin{Description}\relax
Draw a pie chart.\end{Description}
\begin{Usage}
\begin{verbatim}
piechart(x, labels=names(x), shadow=FALSE,
        edges=200, radius=0.8, fill=NULL, main=NULL, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] a vector of positive quantities.
The values in \code{x} are displayed as the areas of pie slices.
\item[\code{labels}] a vector of character strings giving names for
the slices.
\item[\code{shadow}] a logical vector indicating whether a shadow
effect should be attempted for the chart.
This only makes sense if the slices are filled with colors.
\item[\code{edges}] the circular outline of the pie is approximated by a
polygon with this many edges.
\item[\code{radius}] the pie is drawn centered in a square box
whose sides range from \eqn{-1}{} to \eqn{1}{}.
If the character strings labeling the slices are long it
may be necessary to use a smaller radius.
\item[\code{col}] a vector of colors to be used in filling
the slices.
\item[\code{main}] an overall title for the plot.
\item[\code{...}] graphical parameters can be given as arguments to \code{piechart}.
\end{ldescription}
\end{Arguments}
\begin{Note}\relax
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.\end{Note}
\begin{SeeAlso}\relax
\code{\Link{dotplot}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
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)))
\end{ExampleCode}
\end{Examples}

