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, массив, который указывает дробную часть радиуса, на которую следует сместить каждый сектор.

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

Возвращаемое значение:

patchesсписок

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

textsсписок

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

autotextsсписок

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

Примечания

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

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

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

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

Столбец-круговая

Столбец-круговая

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

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

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

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

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

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

pie(x)

pie(x)