matplotlib 3.5.1

NotesParametersReturns
pie(self, x, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=0, radius=1, counterclock=True, wedgeprops=None, textprops=None, center=(0, 0), frame=False, rotatelabels=False, *, normalize=True, data=None)

Make a pie chart of array x. The fractional area of each wedge is given by x/sum(x) . If sum(x) < 1 , then the values of x give the fractional area directly and the array will not be normalized. The resulting pie will have an empty wedge of size 1 - sum(x) .

The wedges are plotted counterclockwise, by default starting from the x-axis.

Notes

The pie chart will probably look best if the figure and Axes are square, or the Axes aspect is equal. This method sets the aspect ratio of the axis to "equal". The Axes aspect ratio can be controlled with :None:None:`.Axes.set_aspect`.

Parameters

x : 1D array-like

The wedge sizes.

explode : array-like, default: None

If not None, is a len(x) array which specifies the fraction of the radius with which to offset each wedge.

labels : list, default: None

A sequence of strings providing the labels for each wedge

colors : array-like, default: None

A sequence of colors through which the pie chart will cycle. If None, will use the colors in the currently active cycle.

autopct : None or str or callable, default: None

If not None, is a string or function used to label the wedges with their numeric value. The label will be placed inside the wedge. If it is a format string, the label will be fmt % pct . If it is a function, it will be called.

pctdistance : float, default: 0.6

The ratio between the center of each pie slice and the start of the text generated by autopct. Ignored if autopct is None.

shadow : bool, default: False

Draw a shadow beneath the pie.

normalize : bool, default: True

When True, always make a full pie by normalizing x so that sum(x) == 1 . False makes a partial pie if sum(x) <= 1 and raises a :None:None:`ValueError` for sum(x) > 1 .

labeldistance : float or None, default: 1.1

The radial distance at which the pie labels are drawn. If set to None , label are not drawn, but are stored for use in legend()

startangle : float, default: 0 degrees

The angle by which the start of the pie is rotated, counterclockwise from the x-axis.

radius : float, default: 1

The radius of the pie.

counterclock : bool, default: True

Specify fractions direction, clockwise or counterclockwise.

wedgeprops : dict, default: None

Dict of arguments passed to the wedge objects making the pie. For example, you can pass in wedgeprops = {'linewidth': 3} to set the width of the wedge border lines equal to 3. For more details, look at the doc/arguments of the wedge object. By default clip_on=False .

textprops : dict, default: None

Dict of arguments to pass to the text objects.

center : (float, float), default: (0, 0)

The coordinates of the center of the chart.

frame : bool, default: False

Plot Axes frame with the chart if true.

rotatelabels : bool, default: False

Rotate each label to the angle of the corresponding slice if true.

data : indexable object, optional

If given, the following parameters also accept a string s , which is interpreted as data[s] (unless this raises an exception):

x, explode, labels, colors

Returns

patches : list

A sequence of matplotlib.patches.Wedge instances

texts : list

A list of the label :None:None:`.Text` instances.

autotexts : list

A list of :None:None:`.Text` instances for the numeric labels. This will only be returned if the parameter autopct is not None.

Plot a pie chart.

Examples

See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


File: /matplotlib/axes/_axes.py#2932
type: <class 'function'>
Commit: