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

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

Создаёт круговую диаграмму массива x. Доля площади каждого сектора задаётся значением x/sum(x). Если sum(x) < 1, тогда значения в x задают долю площади напрямую, и массив не будет нормализован. Результирующая диаграмма будет содержать пустой сектор размером 1 - sum(x).

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

Параметры

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

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

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

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

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.

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