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, data=None)[source]

Построение круговой диаграммы.

Создает круговую диаграмму из массива x. Доля площади каждого сегмента задаётся значением x/sum(x).

Сегменты строятся против часовой стрелки, по умолчанию начиная с оси X.

Параметры:

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

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

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

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

labelsсписок, по умолчанию: None

Последовательность строк, предоставляющих метки для каждого сегмента.

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

Последовательность цветов, по которой будет циклически проходить круговая диаграмма. Если None, будут использоваться цвета из текущего цикла.

autopctNone или str или вызываемый объект, по умолчанию: None

Если не None, это строка или функция, используемая для маркировки сегментов их числовым значением. Метка будет помещена внутри сегмента. Если это строковый формат, метка будет fmt % pct. Если это функция, она будет вызвана.

pctdistanceвещественное число, по умолчанию: 0.6

Отношение между центром каждого сегмента круговой диаграммы и началом текста, сгенерированного autopct. Игнорируется, если autopct равно None.

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

Нарисовать тень под диаграммой.

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

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

labeldistanceчисловое значение или None, по умолчанию: 1.1

Радиальное расстояние, на котором наносятся метки сегментов. Если установлено значение None, метки не выводятся, но сохраняются для использования в legend().

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

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

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

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

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

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

wedgepropsсловарь, по умолчанию: None

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

textpropsсловарь, по умолчанию: None

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

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

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

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

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

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

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

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

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

x, explode, labels, colors

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

patchesсписок

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

textsсписок

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

autotextsсписок

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

Примечания

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