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). Если sum(x) < 1, то значения x задают долю площади непосредственно и массив не будет нормирован. В результате будет пустой сектор размером 1 - sum(x).

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

Параметры

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

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

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

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

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

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

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

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

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

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

pctdistanceчисло, по умолчанию: 0.6

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

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

Отобразить тень под круговой диаграммой.

normalizeбулево значение, по умолчанию: 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

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

counterclockбулево значение, по умолчанию: True

Укажите направление отсечения, по или против часовой стрелки.

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

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

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

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

center(число с плавающей точкой, число с плавающей точкой), по умолчанию: (0, 0)

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

frameбулево значение, по умолчанию: False

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

rotatelabelsбулево значение, по умолчанию: False

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

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

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

x, explode, labels, colors

Возвращает

patchesсписок

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

textsсписок

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

autotextsсписок

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

Примечания

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