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.

Параметры:

Параметры:	`x : array-like` Размеры секторов. `explode : array-like, optional, default: None` Если не None, это массив `len(x)`, который задаёт долю радиуса смещения каждого сектора. `labels : list, optional, default: None` Последовательность строк, задающая метки для каждого сектора. `colors : array-like, optional, default: None` Последовательность аргументов цвета matplotlib, по которым будет циклически выбираться цвет для круговой диаграммы. Если None, будет использоваться цвет из текущего цикла. `autopct : None (default), string, or function, optional` Если не None, строка или функция, используемая для маркировки секторов их числовым значением. Метка будет размещена внутри сектора. Если это строка формата, метка будет `fmt%pct`. Если это функция, она будет вызвана. `pctdistance : float, optional, default: 0.6` Соотношение между центром каждого сектора и началом текста, сгенерированного autopct. Игнорируется, если autopct равно None. `shadow : bool, optional, default: False` Отобразить тень под круговой диаграммой. `labeldistance : float or None, optional, default: 1.1` Радиальное расстояние, на котором будут отображаться метки круговой диаграммы. Если установлено в `None`, метки не отображаются, но сохраняются для использования в `legend()`. `startangle : float, optional, default: None` Если не None, вращает начало круговой диаграммы на angle градусов против часовой стрелки от оси X. `radius : float, optional, default: None` Радиус круговой диаграммы, если radius равен None, он будет установлен в 1. `counterclock : bool, optional, default: True` Указывает направление секторов: по или против часовой стрелки. `wedgeprops : dict, optional, default: None` Словарь аргументов, передаваемых объектам сектора, составляющим круговую диаграмму. Например, можно передать `wedgeprops = {'linewidth': 3}` для установки ширины границ секторов равной 3. Для получения более подробной информации см. документацию по аргументам объекта сектора. По умолчанию `clip_on=False`. `textprops : dict, optional, default: None` Словарь аргументов, передаваемых объектам текстового типа. `center : list of float, optional, default: (0, 0)` Центральная позиция диаграммы. Принимает значение (0, 0) или последовательность из 2 скаляров. `frame : bool, optional, default: False` Отображать рамку осей графика вместе с диаграммой, если значение true. `rotatelabels : bool, optional, default: False` Вращать каждую метку под углом соответствующего сектора, если значение true.
Возвращаемые значения:	`patches : list` Последовательность объектов `matplotlib.patches.Wedge` `texts : list` Список объектов меток `matplotlib.text.Text`. `autotexts : list` Список объектов `Text` для числовых меток. Будет возвращен только в том случае, если параметр autopct не равен None.

x : array-like: Размеры секторов.
explode : array-like, optional, default: None: Если не None, это массив len(x), который задаёт долю радиуса смещения каждого сектора.
labels : list, optional, default: None: Последовательность строк, задающая метки для каждого сектора.
colors : array-like, optional, default: None: Последовательность аргументов цвета matplotlib, по которым будет циклически выбираться цвет для круговой диаграммы. Если None, будет использоваться цвет из текущего цикла.
autopct : None (default), string, or function, optional: Если не None, строка или функция, используемая для маркировки секторов их числовым значением. Метка будет размещена внутри сектора. Если это строка формата, метка будет fmt%pct. Если это функция, она будет вызвана.
pctdistance : float, optional, default: 0.6: Соотношение между центром каждого сектора и началом текста, сгенерированного autopct. Игнорируется, если autopct равно None.
shadow : bool, optional, default: False: Отобразить тень под круговой диаграммой.
labeldistance : float or None, optional, default: 1.1: Радиальное расстояние, на котором будут отображаться метки круговой диаграммы. Если установлено в None, метки не отображаются, но сохраняются для использования в legend().
startangle : float, optional, default: None: Если не None, вращает начало круговой диаграммы на angle градусов против часовой стрелки от оси X.
radius : float, optional, default: None: Радиус круговой диаграммы, если radius равен None, он будет установлен в 1.
counterclock : bool, optional, default: True: Указывает направление секторов: по или против часовой стрелки.
wedgeprops : dict, optional, default: None: Словарь аргументов, передаваемых объектам сектора, составляющим круговую диаграмму. Например, можно передать wedgeprops = {'linewidth': 3} для установки ширины границ секторов равной 3. Для получения более подробной информации см. документацию по аргументам объекта сектора. По умолчанию clip_on=False.
textprops : dict, optional, default: None: Словарь аргументов, передаваемых объектам текстового типа.
center : list of float, optional, default: (0, 0): Центральная позиция диаграммы. Принимает значение (0, 0) или последовательность из 2 скаляров.
frame : bool, optional, default: False: Отображать рамку осей графика вместе с диаграммой, если значение true.
rotatelabels : bool, optional, default: False: Вращать каждую метку под углом соответствующего сектора, если значение true.

Возвращаемые значения:

patches : list: Последовательность объектов matplotlib.patches.Wedge
texts : list: Список объектов меток matplotlib.text.Text.
autotexts : list: Список объектов Text для числовых меток. Будет возвращен только в том случае, если параметр autopct не равен None.

Примечания

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

Примечание

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

Все аргументы с именами: 'colors', 'explode', 'labels', 'x'.

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

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

../../_images/sphx_glr_pie_features_thumb.png

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

../../_images/sphx_glr_pie_demo2_thumb.png

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

../../_images/sphx_glr_nested_pie_thumb.png

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

../../_images/sphx_glr_pie_and_donut_labels_thumb.png

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

matplotlib.pyplot.pie

Примечания

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

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