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.

Параметры:

Параметры:	`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` Отобразить рамку осей графика с диаграммой, если значение истинно. `rotatelabels : bool, optional, default: False` Повернуть каждую метку к углу соответствующего сектора, если значение истинно.
Возвращает:	`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: Отобразить рамку осей графика с диаграммой, если значение истинно.
rotatelabels : bool, optional, default: False: Повернуть каждую метку к углу соответствующего сектора, если значение истинно.

Возвращает:

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.axes.Axes.pie`

../../_images/sphx_glr_pie_features_thumb.png

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

../../_images/sphx_glr_pie_demo2_thumb.png

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

../../_images/sphx_glr_bar_of_pie_thumb.png

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

../../_images/sphx_glr_nested_pie_thumb.png

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

../../_images/sphx_glr_pie_and_donut_labels_thumb.png

Метки круговой и донат-диаграмм

matplotlib.axes.Axes.pie

Примечания

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

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