matplotlib.pyplot.pie

matplotlib.pyplot.pie(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 Отобразить рамку осей графика с диаграммой, если true. rotatelabelsbool, optional, default: False Вращать каждую метку под углом соответствующего сектора, если true.

Возвращает:

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.pyplot.pie

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

Круговая диаграмма Demo2

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

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

Примеры графиков в Matplotlib

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