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.

Parameters:

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

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

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

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

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.

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

Если bool, рисует ли тень под круговой диаграммой. Если dict, рисует тень, передавая свойства в dict в Shadow.

Добавлена в версии 3.8: shadow может быть dict.

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

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

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

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

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

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

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

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

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

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

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

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

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

Рисовать рамку осей с диаграммой, если True.

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

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

normalizebool, по умолчанию: 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.

Примечания

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

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

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

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

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

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

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

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

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

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