PieChart - Maple Help

Statistics

 PieChart
 generate pie charts

 Calling Sequence PieChart(X, options, plotoptions) PieChart['interactive'](X)

Parameters

 X - data options - (optional) equation(s) of the form option=value where option is one of datasetlabels, color, explode, sector, annular, or render3d; specify options for generating the pie chart plotoptions - options to be passed to the plots[display] command

Description

 • The PieChart command generates a pie chart for the specified data.
 • The first parameter X is a list of equations of the form value=frequency. A list or Vector of values can also be given, in which case all frequencies are set equal.
 • If the ['interactive'] option is used, then a dialog box appears that allows for customized creation of the plot.

Options

 The options argument can contain one or more of the options shown below. All unrecognized options will be passed to the plots[display] command. See plot/options for details.
 • datasetlabels=default, none, relative, absolute, or list
 This option controls data set labels on the pie slices. By default, PieChart uses data values as labels. The relative option displays, for each pie slice, the percentage value that pie slice occupies in the pie. The absolute option displays, for each pie slice, the absolute frequency of the corresponding value. Finally, you can specify data set labels as a list of strings.
 • sector=range
 This option specifies (in degrees) which part of the pie will be used by the chart. The default value is $0..360$.
 • color=name, list, or range
 This option specifies colors for the individual data sets. When a list of colors is given, each of the pie slices is colored with the corresponding color in the list.
 If a range of colors is given, the colors are generated by selecting an appropriate number of points using the command ColorTools[Gradient] with the best option. In this case:
 – If the sector option is used to select less than the full pie, the colors of the slices will be assigned so that one end of the sector has the first color, and the other end has the other color.
 – If the full pie is selected (by omitting the sector option, or by explicitly selecting sector = 0 .. 360), then the colors of the slices will be assigned so that they are continuous along the full pie: one slice will have the first specified color, then subsequent colors in the range are assigned alternatingly to the next uncolored slice counterclockwise and the next uncolored slice clockwise, continuing until the last slice gets the second specified color.
 • explode=list
 If X is a Vector or a list, specify the list of indices in X which corresponds to the pie slice to be exploded. They need not be in order. If X is a list of equations, specify the left-hand side values in the list which corresponds to the pie slice to be exploded.
 • annular=true, false, nonnegative, or range
 This option specifies that the PieChart should be drawn on an annulus instead of a disk.  If the option is given alone or as annular=true then an annulus of inside radius 1 and outside radius 2 is used.  If a number is specified, that number is used for the inside radius and the outside radius is one greater.  This is useful for nesting charts. If a range is specified, the left- and right-hand sides of the range are used for the inside and outside radii (respectively).
 • render3d=true, false, or nonnegative
 This option specifies that the PieChart should be drawn as a 3-D plot.  If the option is given alone or as render3d=true then the a circular chart is drawn with thickness 0.5, and an annular chart is drawn with a thickness corresponding to 1/2 of its outer radius plus one. If an integer is given then the chart will be as thick as an annular chart with that inside radius.  If a non-integer number is specified, it is used as the exact thickness of the chart.

Examples

 > $\mathrm{with}\left(\mathrm{Statistics}\right):$
 > $\mathrm{PieChart}\left(\left[1,1,2,3\right]\right)$
 > $A≔\left[\mathrm{seq}\left(i=\mathrm{sqrt}\left(i\right),i=1..15\right)\right]:$
 > $\mathrm{PieChart}\left(A,\mathrm{sector}=0..180\right)$
 > $B≔\left[\mathrm{seq}\left(i=\mathrm{sqrt}\left(\mathrm{abs}\left(7-i\right)\right)+1,i=1..16,2\right)\right]$
 ${B}{≔}\left[{1}{=}\sqrt{{6}}{+}{1}{,}{3}{=}{3}{,}{5}{=}\sqrt{{2}}{+}{1}{,}{7}{=}{1}{,}{9}{=}\sqrt{{2}}{+}{1}{,}{11}{=}{3}{,}{13}{=}\sqrt{{6}}{+}{1}{,}{15}{=}{2}{}\sqrt{{2}}{+}{1}\right]$ (1)
 > $\mathrm{PieChart}\left(B,\mathrm{sector}=0..270,\mathrm{annular}\right)$
 > $\mathrm{plots}\left[\mathrm{display}\right]\left(\mathrm{PieChart}\left(A,\mathrm{annular}=1\right),\mathrm{PieChart}\left(B,\mathrm{sector}=90..270,\mathrm{annular}=2\right)\right)$
 > $\mathrm{plots}\left[\mathrm{display}\right]\left(\mathrm{PieChart}\left(A,\mathrm{annular}=1,\mathrm{render3d}\right),\mathrm{PieChart}\left(B,\mathrm{sector}=90..270,\mathrm{annular}=2,\mathrm{render3d}=1\right)\right)$

The commands to create the plot from the Plotting Guide are

 > $T≔\left[\mathrm{StringTools}:-\mathrm{CharacterFrequencies}\left("honorificabilitudinitatibus"\right)\right]$
 ${T}{≔}\left[{"a"}{=}{2}{,}{"b"}{=}{2}{,}{"c"}{=}{1}{,}{"d"}{=}{1}{,}{"f"}{=}{1}{,}{"h"}{=}{1}{,}{"i"}{=}{7}{,}{"l"}{=}{1}{,}{"n"}{=}{2}{,}{"o"}{=}{2}{,}{"r"}{=}{1}{,}{"s"}{=}{1}{,}{"t"}{=}{3}{,}{"u"}{=}{2}\right]$ (2)
 > $\mathrm{PieChart}\left(T,\mathrm{color}="Crimson".."Gold",\mathrm{explode}=\left[\mathrm{seq}\left(i,i="a".."i"\right)\right]\right)$
 > $\mathrm{plots}\left[\mathrm{display}\right]\left(\mathrm{PieChart}\left(A,\mathrm{sector}=45..225,\mathrm{annular}=2.25..4,\mathrm{color}="MediumTurquoise".."MediumVioletRed"\right),\mathrm{PieChart}\left(B,\mathrm{sector}=30..270,\mathrm{annular}=1,\mathrm{color}="MediumTurquoise".."Navy"\right),\mathrm{PieChart}\left(A\left[5..10\right],\mathrm{annular}=\mathrm{false},\mathrm{color}="Navy".."MediumTurquoise"\right),\mathrm{PieChart}\left(T,\mathrm{color}="Crimson".."Gold",\mathrm{explode}=\left[\mathrm{seq}\left(i,i="j".."u"\right)\right],\mathrm{annular}=4.25..6\right)\right)$
 > 

Compatibility

 • The annular and render3d options were introduced in Maple 16.