Note
Go to the end to download the full example code.
Pie charts#
Demo of plotting a pie chart.
This example illustrates various parameters of pie
.
Label slices#
Plot a pie chart of animals and label the slices. To add labels, pass a list of labels to the labels parameter
![pie features](../../_images/sphx_glr_pie_features_001.png)
Each slice of the pie chart is a patches.Wedge
object; therefore in
addition to the customizations shown here, each wedge can be customized using
the wedgeprops argument, as demonstrated in
Nested pie charts.
Auto-label slices#
Pass a function or format string to autopct to label slices.
![pie features](../../_images/sphx_glr_pie_features_002.png)
By default, the label values are obtained from the percent size of the slice.
Color slices#
Pass a list of colors to colors to set the color of each slice.
![pie features](../../_images/sphx_glr_pie_features_003.png)
Hatch slices#
Pass a list of hatch patterns to hatch to set the pattern of each slice.
![pie features](../../_images/sphx_glr_pie_features_004.png)
Swap label and autopct text positions#
Use the labeldistance and pctdistance parameters to position the labels and autopct text respectively.
![pie features](../../_images/sphx_glr_pie_features_005.png)
labeldistance and pctdistance are ratios of the radius; therefore they
vary between 0
for the center of the pie and 1
for the edge of the
pie, and can be set to greater than 1
to place text outside the pie.
Explode, shade, and rotate slices#
In addition to the basic pie chart, this demo shows a few optional features:
offsetting a slice using explode
add a drop-shadow using shadow
custom start angle using startangle
This example orders the slices, separates (explodes) them, and rotates them.
![pie features](../../_images/sphx_glr_pie_features_006.png)
The default startangle is 0, which would start the first slice ("Frogs") on
the positive x-axis. This example sets startangle = 90
such that all the
slices are rotated counter-clockwise by 90 degrees, and the frog slice starts
on the positive y-axis.
Controlling the size#
By changing the radius parameter, and often the text size for better visual appearance, the pie chart can be scaled.
![pie features](../../_images/sphx_glr_pie_features_007.png)
Modifying the shadow#
The shadow parameter may optionally take a dictionary with arguments to
the Shadow
patch. This can be used to modify the default shadow.
![pie features](../../_images/sphx_glr_pie_features_008.png)
References
The use of the following functions, methods, classes and modules is shown in this example:
Total running time of the script: (0 minutes 2.408 seconds)