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

Замечания

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

Примечание

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

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

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

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

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

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

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

Маркировка круговой и пончиковой диаграмм