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.

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.

Примечания

Примечание

Это обертка pyplot для axes.Axes.pie.

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

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

Диаграммы круга

Диаграммы круга

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

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

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

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

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

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