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, hold=None, 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.pyplot.pie

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

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

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

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