matplotlib.axes.Axes.pie

Axes.pie(self, x, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=None, radius=None, counterclock=True, wedgeprops=None, textprops=None, center=0, 0, frame=False, rotatelabels=False, *, data=None) [source]

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

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

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

Параметры:

xarray-like Размеры секторов. explodearray-like, optional, default: None Если не None, это массив, который задаёт отношение радиуса смещения каждого сектора. labelslist, optional, default: None Последовательность строк, задающая метки для каждого сектора. colorsarray-like, optional, default: None Последовательность аргументов цвета matplotlib, по которым циклически будут выбираться цвета для круговой диаграммы. Если None, будут использованы цвета из текущего цикла. autopctNone (default), str, or function, optional Если не None, это строка или функция, используемая для маркировки секторов их численным значением. Метка будет размещена внутри сектора. Если это строка-формат, метка будет fmt%pct. Если это функция, она будет вызвана. pctdistancefloat, optional, default: 0.6 Соотношение между центром каждого сектора круговой диаграммы и началом текста, сгенерированного параметром autopct. Игнорируется, если autopct равно None. shadowbool, optional, default: False Отображать тень под круговой диаграммой. labeldistancefloat or None, optional, default: 1.1 Радиальное расстояние, на котором наносятся метки секторов. Если установлено в None, метки не отображаются, но хранятся для использования в legend() startanglefloat, optional, default: None Если не None, поворачивает начало круговой диаграммы на angle градусов против часовой стрелки от оси X. radiusfloat, optional, default: None Радиус круговой диаграммы. Если radius равно None, он будет установлен в 1. counterclockbool, optional, default: True Укажите направление секторов: по или против часовой стрелки. wedgepropsdict, optional, default: None Словарь аргументов, передаваемых объектам секторов, составляющим круговую диаграмму. Например, вы можете передать wedgeprops = {'linewidth': 3} чтобы установить ширину границ секторов равной 3. Для получения более подробной информации см. документацию по аргументам объекта сектора. По умолчанию clip_on=False. textpropsdict, optional, default: None Словарь аргументов для передачи текстовым объектам. centerlist of float, optional, default: (0, 0) Центральная позиция диаграммы. Принимает значение (0, 0) или последовательность из 2 скаляров. framebool, optional, default: False Отображать рамку осей с диаграммой, если истинно. rotatelabelsbool, optional, default: False Повернуть каждую метку к углу соответствующего сектора, если истинно.

Возвращает:

patcheslist Последовательность экземпляров matplotlib.patches.Wedge. textslist Список экземпляров меток matplotlib.text.Text. autotextslist Список экземпляров Text для числовых меток. Это будет возвращено только если параметр autopct не равен None.

Примечания

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

Примечание

Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы со следующими именами: 'colors', 'explode', 'labels', 'x'.

Объекты, переданные как data, должны поддерживать доступ к элементам (data[<arg>]) и проверку на вхождение (<arg> in data).

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

Простая круговая диаграмма

Пример круговой диаграммы 2

Круговая диаграмма с графиком столбцов

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

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

Круговая диаграмма с SVG-фильтром