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=0, radius=1, counterclock=True, wedgeprops=None, textprops=None, center=0, 0, frame=False, rotatelabels=False, *, normalize=None, data=None) [source]

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

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

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

Параметры:

x1D array-like Величины секторов. explodearray-like, default: None Если не None, массив, который указывает долю радиуса, на которую нужно сместить каждый сектор. labelslist, default: None Последовательность строк, представляющих метки для каждого сектора colorsarray-like, default: None Последовательность цветов, которые будут использоваться для круговой диаграммы. Если None, будут использованы цвета из текущего цикла. autopctNone or str or callable, default: None Если не None, строка или функция, используемая для маркировки секторов их числовым значением. Метка будет помещена внутри сектора. Если это строка формата, метка будет fmt % pct. Если это функция, она будет вызвана. pctdistancefloat, default: 0.6 Соотношение между центром каждого сегмента круговой диаграммы и началом текста, генерируемого autopct. Игнорируется, если autopct равно None. shadowbool, default: False Отобразить тень под круговой диаграммой. normalize: None или bool, по умолчанию: None Когда True, всегда отображается полная круговая диаграмма, нормируя x таким образом, что sum(x) == 1. False создаёт частичную круговую диаграмму, если sum(x) <= 1 и генерирует ValueError для sum(x) > 1. Когда None, по умолчанию True, если sum(x) >= 1 и False, если sum(x) < 1. Обратите внимание, что предыдущее значение по умолчанию None теперь устарело, и в следующем выпуске значение по умолчанию изменится на True. Пожалуйста, явно передавайте normalize=False для отображения частичной круговой диаграммы. labeldistancefloat or None, default: 1.1 Радиальное расстояние, на котором отображаются метки круговой диаграммы. Если установлено в None, метки не отображаются, но сохраняются для использования в legend() startanglefloat, default: 0 degrees Угол поворота начала круговой диаграммы против часовой стрелки от оси x. radiusfloat, default: 1 Радиус круговой диаграммы. counterclockbool, default: True Указывает направление отсеков, по часовой или против часовой стрелки. wedgepropsdict, default: None Словарь аргументов, передаваемых объектам сектора, образующим круговую диаграмму. Например, вы можете передать wedgeprops = {'linewidth': 3} для установки ширины линий границ сектора равной 3. Для получения более подробной информации см. документацию по аргументам объекта сектора. По умолчанию clip_on=False. textpropsdict, default: None Словарь аргументов, передаваемых текстовым объектам. center(float, float), default: (0, 0) Координаты центра диаграммы. framebool, default: False Если true, отображает рамку осей с диаграммой. rotatelabelsbool, default: False Если true, вращает каждую метку под углом соответствующего сектора.

Возвращает:

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

Примечания

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

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, explode, labels, colors.

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

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

Базовая круговая диаграмма

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

Диаграмма "столбец-круговая диаграмма"

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

Метки круговой диаграммы и пончика

SVG фильтр круговой диаграммы