matplotlib.axes.Axes.pie

Axes.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, это массив, который указывает долю радиуса, на которую нужно сместить каждый сектор. 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, optional, default: 1.1 Радиальное расстояние, на котором отображаются метки для секторов. 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.

Замечания

Круговая диаграмма, скорее всего, будет выглядеть лучше, если фигура и оси квадратные или аспект осей равен.

Примечание

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

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

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

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

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

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