matplotlib.axes.Axes.pie

Axes.pie(x, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=0, radius=1, counterclock=True, wedgeprops=None, textprops=None, center=(0, 0), frame=False, rotatelabels=False, *, normalize=True, data=None)[source]

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

Построение круговой диаграммы для массива x. Доля площади каждого сектора задаётся значением x/sum(x).

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

Parameters:

xОдномерный массив-подобный объект

Размеры секторов.

explodeмассив-подобный объект, по умолчанию: None

Если не None, это len(x) массив, который определяет долю радиуса, на которую смещается каждый сектор.

labelsсписок, по умолчанию: None

Последовательность строк, предоставляющих метки для каждого сектора.

colorsмассив-подобный объект, по умолчанию: None

Последовательность цветов, используемых для циклического отображения круговой диаграммы. Если None, используются цвета из текущего цикла.

autopctNone или str или вызываемый объект, по умолчанию: None

Если не None, это строка или функция, используемая для маркировки секторов с их численным значением. Метка будет размещена внутри сектора. Если это строка формата, метка будет fmt % pct. Если это функция, она будет вызвана.

pctdistancefloat, по умолчанию: 0.6

Соотношение между центром каждого сегмента круговой диаграммы и началом текста, сгенерированного параметром autopct. Игнорируется, если autopct равно None.

shadowbool, по умолчанию: False

Отобразить тень под круговой диаграммой.

normalizebool, по умолчанию: True

Когда True, всегда создаётся полная круговая диаграмма, нормализуя x таким образом, что sum(x) == 1. False создаёт частичную круговую диаграмму, если sum(x) <= 1 и вызывает ValueError для sum(x) > 1.

labeldistancefloat или None, по умолчанию: 1.1

Радиальное расстояние, на котором отображаются метки секторов круговой диаграммы. Если установлено значение None, метки не отображаются, но хранятся для использования в legend().

startanglefloat, по умолчанию: 0 градусов

Угол, на который поворачивается начало круговой диаграммы против часовой стрелки от оси x.

radiusfloat, по умолчанию: 1

Радиус круговой диаграммы.

counterclockbool, по умолчанию: True

Определяет направление отсекаемых долей, по часовой или против часовой стрелки.

wedgepropsdict, по умолчанию: None

Словарь аргументов, передаваемых объектам сектора, образующим круговую диаграмму. Например, вы можете передать wedgeprops = {'linewidth': 3} , чтобы установить ширину линий границы секторов равной 3. Для получения более подробной информации, см. документ по аргументам объекта сектора. По умолчанию clip_on=False.

textpropsdict, по умолчанию: None

Словарь аргументов для передачи текстовым объектам.

center(float, float), по умолчанию: (0, 0)

Координаты центра диаграммы.

framebool, по умолчанию: False

Отобразить рамку осей с диаграммой, если True.

rotatelabelsbool, по умолчанию: False

Повернуть каждую метку под углом соответствующего сектора, если True.

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, explode, labels, colors

Returns:

patchesсписок

Последовательность экземпляров matplotlib.patches.Wedge

textsсписок

Список метки Text экземпляров.

autotextsсписок

Список экземпляров Text для числовых меток. Это будет возвращено только в том случае, если параметр autopct не None.

Примечания

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

Примеры, использующие matplotlib.axes.Axes.pie

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

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

Столбчатая круговая диаграмма

Столбчатая круговая диаграмма

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

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

Метки круговой и кольцевой диаграмм

Метки круговой и кольцевой диаграмм

Круговая диаграмма SVG-фильтра

Круговая диаграмма SVG-фильтра

pie(x)

pie(x)