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.

Параметры:

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

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

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.

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

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

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

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.axes.Axes.pie

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

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

Столбец из круговой диаграммы

Столбец из круговой диаграммы

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

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

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

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

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

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

pie(x)

pie(x)