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, hatch=None, data=None)[source]

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

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

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

Parameters:

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

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

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

Если не None, это массив, который задаёт долю радиуса смещения каждого сектора.

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

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

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

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

hatchстрока или список, по умолчанию: None

Шаблон штриховки, применяемый ко всем секторам круговой диаграммы или последовательность шаблонов, по которым будет циклически выбираться диаграмма. Для списка допустимых шаблонов см. Список шаблонов штриховки.

Добавлен в версии 3.7.

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

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

pctdistanceвещественное число, по умолчанию: 0.6

Относительное расстояние по радиусу, на котором отображается текст, сгенерированный autopct. Чтобы отобразить текст за пределами круговой диаграммы, установите pctdistance > 1. Этот параметр игнорируется, если autopct – None.

labeldistanceвещественное число или None, по умолчанию: 1.1

Относительное расстояние по радиусу, на котором отображаются метки. Чтобы отобразить метки внутри круговой диаграммы, установите labeldistance < 1. Если установлено значение None, метки не отображаются, но всё ещё хранятся для использования в legend.

shadowбулево значение, по умолчанию: False

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

startangleвещественное число, по умолчанию: 0 градусов

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

radiusвещественное число, по умолчанию: 1

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

counterclockбулево значение, по умолчанию: True

Указывает направление секторов, по или против часовой стрелки.

wedgepropsсловарь, по умолчанию: None

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

textpropsсловарь, по умолчанию: None

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

center(вещественное число, вещественное число), по умолчанию: (0, 0)

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

frameбулево значение, по умолчанию: False

Построение рамки осей с диаграммой, если истинно.

rotatelabelsбулево значение, по умолчанию: False

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

normalizeбулево значение, по умолчанию: True

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

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

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

x, explode, labels, colors

Returns:

patchesсписок

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

textsсписок

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

autotextsсписок

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

Notes

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

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

Круговые диаграммы

Круговые диаграммы

Демонстрация круговых диаграмм 2

Демонстрация круговых диаграмм 2

Столбец-сектор

Столбец-сектор

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

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

Подписи круговой и кольцевой диаграмм

Подписи круговой и кольцевой диаграмм

SVG-фильтр круговой диаграммы

SVG-фильтр круговой диаграммы

pie(x)

pie(x)