matplotlib.axes.Axes.pie

Axes.pie(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) [source]

Построение круговой диаграммы.

Создаёт круговую диаграмму для массива x. Доля площади каждого сектора задаётся значением x/sum(x). Если sum(x) < 1, то значения в x напрямую определяют долю площади, и массив не будет нормализован. В результате получится круговая диаграмма с пустым сектором размером 1 - sum(x).

Секторы отображаются против часовой стрелки, по умолчанию начиная с оси x.

Параметры:

x : array-like Величины секторов. explode : array-like, optional, default: None Если не None, это массив, который определяет долю радиуса, на которую смещается каждый сектор. labels : list, optional, default: None Последовательность строк, предоставляющих метки для каждого сектора. colors : array-like, optional, default: None Последовательность аргументов цветов matplotlib, которые будут циклически использоваться для круговой диаграммы. Если None, будут использоваться цвета из текущего активного цикла. autopct : None (default), string, or function, optional Если не None, это строка или функция, используемая для маркировки секторов с их числовым значением. Метка будет размещена внутри сектора. Если это строка форматирования, метка будет fmt%pct. Если это функция, она будет вызвана. pctdistance : float, optional, default: 0.6 Отношение между центром каждого сегмента круговой диаграммы и началом текста, сгенерированного autopct. Игнорируется, если autopct равно None. shadow : bool, optional, default: False Отобразить тень под круговой диаграммой. labeldistance : float, optional, default: 1.1 Радиальное расстояние, на котором отображаются метки круговой диаграммы. startangle : float, optional, default: None Если не None, поворачивает начало круговой диаграммы на angle градусов против часовой стрелки от оси x. radius : float, optional, default: None Радиус круговой диаграммы, если radius равно None, он будет установлен в 1. counterclock : bool, optional, default: True Укажите направление секторов, по или против часовой стрелки. wedgeprops : dict, optional, default: None Словарь аргументов, передаваемых объектам секторов, составляющим круговую диаграмму. Например, вы можете передать wedgeprops = {'linewidth': 3} для установки ширины линий границ секторов равной 3. Для получения более подробной информации см. документацию по аргументам объекта сектора. По умолчанию clip_on=False. textprops : dict, optional, default: None Словарь аргументов, передаваемых объектам текстовых элементов. center : list of float, optional, default: (0, 0) Положение центра диаграммы. Принимает значение (0, 0) или последовательность из 2 скаляров. frame : bool, optional, default: False Отобразить рамку осей с диаграммой, если True. rotatelabels : bool, optional, default: False Повернуть каждую метку к углу соответствующего сегмента, если True.

Возвращаемое значение:

patches : list Последовательность экземпляров matplotlib.patches.Wedge texts : list Список экземпляров меток matplotlib.text.Text. autotexts : list Список экземпляров Text для числовых меток. Это будет возвращено только в том случае, если параметр autopct не равен None.

Замечания

Круговая диаграмма будет выглядеть лучше всего, если фигура и оси имеют квадратную форму, или если аспект осей равен. Этот метод устанавливает аспект оси в "равный". Аспект оси можно контролировать с помощью Axes.set_aspect.

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы с именами: 'colors', 'explode', 'labels', 'x'.

Объекты, переданные как data, должны поддерживать доступ по элементам (data[<arg>]) и проверку на членство (<arg> in data).

Примеры использования matplotlib.axes.Axes.pie

Базовая круговая диаграмма

Пример круговой диаграммы 2

Вложенные круговые диаграммы

Подписи для круговой и пончиковой диаграмм