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:
Python3
# Implementation of matplotlib functionimport matplotlib.pyplot as pltlabels = '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 functionimport matplotlib.pyplot as pltimport numpy as npfig, ax = plt.subplots()size = 0.3vals = 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:
