Open In App

matplotlib.axes.Axes.pie() in Python

Last Updated : 02 May, 2023
Like Article

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.
  • radius: This parameter is the radius of the pie.
  • 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: 


# 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.set_title('matplotlib.axes.Axes.pie Example')



Example #2: 


# 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')


Like Article
Suggest improvement
Share your thoughts in the comments

Similar Reads