GeeksforGeeks App
Open App
Browser
Continue

# matplotlib.axes.Axes.pie() in Python

Matplotlib is a library in Python and it is numerical – mathematical extension for NumPy library. The Axes Class contains most of the figure elements: Axis, Tick, Line2D, Text, Polygon, etc., and sets the coordinate system. And the instances of Axes supports callbacks through a callbacks attribute.

## matplotlib.axes.Axes.pie() Function

The Axes.pie() function in axes module of matplotlib library is used to plot a pie chart.

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

Parameters: This method accept the following parameters that are described below:

• x: This parameter is the wedge sizes.
• explode: This parameter is the len(x) array which specifies the fraction of the radius with which to offset each wedge.
• autopct: This parameter is a string or function used to label the wedges with their numeric value.
• colors: This parameter is the sequence of matplotlib color args through which the pie chart will cycle.
• label: This parameter is the sequence of strings providing the labels for each wedge.
• pctdistance: This parameter is the ratio between the center of each pie slice and the start of the text generated by autopct.
• shadow: This parameter is the used to draw a shadow beneath the pie.
• labeldistance: This parameter is the radial distance at which the pie labels are drawn.
• startangle: This parameter is used to rotates the start of the pie chart by angle degrees counterclockwise from the x-axis.
• counterclock: This parameter specifies fractions direction, clockwise or counterclockwise.
• wedgeprops: This parameter is dict of arguments passed to the wedge objects making the pie.
• textprops: This parameter is dict of arguments to pass to the text objects.
• center: This parameter is the Center position of the chart.
• frame: This parameter is used to plot axes frame with the chart if true.
• rotatelabels: This parameter is used to rotate each label to the angle of the corresponding slice if true.

Returns: This returns the following:

• patches: This returns the sequence of matplotlib.patches.Wedge instances.
• texts: This returns the list of the label matplotlib.text.Text instances.
• autotexts: This returns the list of Text instances for the numeric labels.

Below examples illustrate the matplotlib.axes.Axes.pie() function in matplotlib.axes:

Example #1:

## Python3

 `# Implementation of matplotlib function``import` `matplotlib.pyplot as plt` `labels ``=` `'Geek1'``, ``'Geek2'``, ``'Geek3'``, ``'Geek4'``sizes ``=` `[``10``, ``20``, ``30``, ``40``]``explode ``=` `(``0.1``, ``0``, ``0``, ``0``)` `fig1, ax1 ``=` `plt.subplots()``ax1.pie(sizes, explode ``=` `explode,``        ``labels ``=` `labels, autopct ``=``'% 1.1f %%'``,``        ``shadow ``=` `True``, startangle ``=` `90``)``ax1.axis(``'equal'``)` `ax1.set_title(``'matplotlib.axes.Axes.pie Example'``)``plt.show()`

Output:

Example #2:

## Python3

 `# Implementation of matplotlib function``import` `matplotlib.pyplot as plt``import` `numpy as np` `fig, ax ``=` `plt.subplots()` `size ``=` `0.3``vals ``=` `np.array([[``90``, ``43``], [``57``, ``60``],``                 ``[``92``, ``20``]])` `cmap ``=` `plt.get_cmap("tab20c")``outer_colors ``=` `cmap(np.arange(``3``)``*``4``)``mid_colors ``=` `cmap(np.array([``1``, ``2``, ``3``, ``4``, ``5``, ]))``inner_colors ``=` `cmap(np.array([``4``, ``12``, ``5``,``                              ``6``, ``9``, ``10``]))` `ax.pie(vals.``sum``(axis ``=` `1``), radius ``=` `1``,``       ``colors ``=` `outer_colors,``       ``wedgeprops ``=` `dict``(width ``=` `size,``                         ``edgecolor ``=``'w'``))` `ax.pie(vals.flatten(), radius ``=` `1``-``size,``       ``colors ``=` `mid_colors,``       ``wedgeprops ``=` `dict``(width ``=` `size,``                         ``edgecolor ``=``'w'``))` `ax.pie(vals.flatten(), radius ``=` `1``-``2` `*` `size,``       ``colors ``=` `inner_colors,``       ``wedgeprops ``=` `dict``(width ``=` `size,``                         ``edgecolor ``=``'w'``))` `ax.set_title(``'matplotlib.axes.Axes.pie Example'``)``plt.show()`

Output:

My Personal Notes arrow_drop_up