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)

Построение круговой диаграммы.

Создаёт круговую диаграмму из массива x. Доля площади каждого сектора задаётся значением x/sum(x). Если sum(x) <= 1, то значения из массива x напрямую определяют долю площади, и массив не будет нормализован. Секторы диаграммы строятся против часовой стрелки, по умолчанию начиная с оси x.

Параметры:

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

Возвращает:

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

Примечания

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

Примечание

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

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

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

Pie Demo2