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)

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

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

Параметры:

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

Возвращаемое значение:

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

Примечания

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

Примечание

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

• Все аргументы с такими именами: ‘colors’, ‘explode’, ‘labels’, ‘x’.