matplotlib.pyplot.pie

matplotlib.pyplot.pie(x, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=0, radius=1, counterclock=True, wedgeprops=None, textprops=None, center=0, 0, frame=False, rotatelabels=False, *, normalize=None, data=None) [source]

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

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

Секторы отображаются против часовой стрелки, по умолчанию начиная с оси x.

Параметры:

x1D array-like Размеры секторов. explodearray-like, default: None Если не None, является массивом len(x), который задаёт долю радиуса для смещения каждого сектора. labelslist, default: None Последовательность строк, предоставляющая метки для каждого сектора colorsarray-like, default: None Последовательность цветов, по которым будет циклически выбираться цвет круговой диаграммы. Если None, будут использоваться цвета из текущего цикла. autopctNone or str or callable, default: None Если не None, является строкой или функцией, используемой для маркировки секторов с их числовым значением. Метка будет размещена внутри сектора. Если это строковый формат, метка будет fmt % pct. Если это функция, она будет вызвана. pctdistancefloat, default: 0.6 Соотношение между центром каждого сектора круговой диаграммы и началом текста, сгенерированного параметром autopct. Игнорируется, если autopct равен None. shadowbool, default: False Отобразить тень под круговой диаграммой. normalize: None или bool, по умолчанию: None Когда True, всегда создаёт полную круговую диаграмму, нормализуя x так, чтобы sum(x) == 1. False создаёт частичную круговую диаграмму, если sum(x) <= 1 и генерирует ValueError для sum(x) > 1. Когда None, по умолчанию True, если sum(x) >= 1, и False, если sum(x) < 1. Обратите внимание, что предыдущее значение по умолчанию None теперь устарело, и значение по умолчанию будет изменено на True в следующем выпуске. Пожалуйста, явно передайте normalize=False, если вы хотите отобразить частичную круговую диаграмму. labeldistancefloat or None, default: 1.1 Радиальное расстояние, на котором отображаются метки круговой диаграммы. Если установлено в значение None, метки не отображаются, но сохраняются для использования в legend() startanglefloat, default: 0 degrees Угол поворота начала круговой диаграммы против часовой стрелки от оси x. radiusfloat, default: 1 Радиус круговой диаграммы. counterclockbool, default: True Указывает направление сектора, по часовой или против часовой стрелки. wedgepropsdict, default: None Словарь аргументов, передаваемых объектам сектора, составляющим круговую диаграмму. Например, вы можете передать wedgeprops = {'linewidth': 3}, чтобы установить ширину линий границы сектора равной 3. Для более подробной информации см. документацию по аргументам объекта сектора. По умолчанию clip_on=False. textpropsdict, default: None Словарь аргументов для передачи объектам текста. center(float, float), default: (0, 0) Координаты центра диаграммы. framebool, default: False Отобразить рамку осей графика с диаграммой, если true. rotatelabelsbool, default: False Повернуть каждую метку к углу соответствующего сектора, если true.

Возвращает:

patcheslist Последовательность объектов matplotlib.patches.Wedge textslist Список объектов меток Text. autotextslist Список объектов Text для числовых меток. Это будет возвращено только в том случае, если параметр autopct не равен None.

Примечания

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

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключение): x, explode, labels, colors.

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

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

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

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

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

Метки круговой и донат-диаграммы

Примеры графиков в Matplotlib