Class PieContainer

lib/matplotlib/container.py:151–220

Container for the artists of pie charts (e.g. created by `.Axes.pie`). .. versionadded:: 3.11 .. warning:: The class name ``PieContainer`` name is provisional and may change in future to reflect development of its functionality. You can access the wedge patches an

class PieContainer:
    """
    Container for the artists of pie charts (e.g. created by `.Axes.pie`).

    .. versionadded:: 3.11

    .. warning::
        The class name ``PieContainer`` name is provisional and may change in future
        to reflect development of its functionality.

    You can access the wedge patches and further parameters by the attributes.

    Attributes
    ----------
    wedges : list of `~matplotlib.patches.Wedge`
        The artists of the pie wedges.

    values : `numpy.ndarray`
        The data that the pie is based on.

    fracs : `numpy.ndarray`
        The fraction of the pie that each wedge represents.

    texts : list of list of `~matplotlib.text.Text`
        The artists of any labels on the pie wedges.  Each inner list has one
        text label per wedge.

    """
    def __init__(self, wedges, values, normalize):
        self.wedges = wedges
        self._texts = []
        self._values = values
        self._normalize = normalize

    @property
    def texts(self):
        # Only return non-empty sublists.  An empty sublist may have been added
        # for backwards compatibility of the Axes.pie return value (see __getitem__).
        return [t_list for t_list in self._texts if t_list]

    @property
    def values(self):
        result = self._values.copy()
        result.flags.writeable = False
        return result

    @property
    def fracs(self):
        if self._normalize:
            result = self._values / self._values.sum()
        else:
            result = self._values

        result.flags.writeable = False
        return result

    def add_texts(self, texts):
        """Add a list of `~matplotlib.text.Text` objects to the container."""