matplotlib.pyplot.pie

matplotlib.pyplot.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.

Параметры:

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

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

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

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

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

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

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

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

x, explode, labels, colors

Возвращает:

patchesсписок

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

textsсписок

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

autotextsсписок

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

Замечания

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

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

Диаграммы рассеяния

Диаграммы рассеяния

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

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

Диаграмма "столбец-сектор"

Диаграмма "столбец-сектор"

Вложенные диаграммы рассеяния

Вложенные диаграммы рассеяния

Подписи диаграммы рассеяния и пончика

Подписи диаграммы рассеяния и пончика