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=None, 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 Отобразить тень под диаграммой. normalizeNone или 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 , если вы хотите нарисовать частичную диаграмму. 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.

Возвращает:

patchesсписок Последовательность экземпляров matplotlib.patches.Wedge textsсписок Список экземпляров меток Text. autotextsсписок Список экземпляров 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

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

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

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

Подпись круговой и донат-диаграмм

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