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.

Параметры:

xОдномерный массив-подобный объект Размеры секторов. explodeмассив-подобный объект, по умолчанию: None Если не None, это len(x) массив, который задаёт долю радиуса для смещения каждого сектора. labelsсписок, по умолчанию: None Последовательность строк, предоставляющих метки для каждого сектора. colorsмассив-подобный объект, по умолчанию: None Последовательность цветов, по которым круговая диаграмма будет циклически использовать. Если None, использует цвета из текущего цикла. autopctNone или строка или вызываемый объект, по умолчанию: None Если не None, это строка или функция, используемая для маркирования секторов их численным значением. Метка будет размещена внутри сектора. Если это строка формата, метка будет fmt % pct. Если это функция, она будет вызвана. pctdistanceчисло, по умолчанию: 0.6 Отношение между центром каждого сегмента круговой диаграммы и началом текста, сгенерированного параметром autopct. Игнорируется, если autopct равно None. shadowbool, по умолчанию: False Отобразить тень под диаграммой. normalizeNone или 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, если хотите нарисовать частичную диаграмму. labeldistanceчисло или None, по умолчанию: 1.1 Радиальное расстояние, на котором отображаются метки секторов. Если установлено None, метки не отображаются, но сохраняются для использования в legend(). startangleчисло, по умолчанию: 0 градусов Угол поворота начала диаграммы против часовой стрелки от оси x. radiusчисло, по умолчанию: 1 Радиус диаграммы. counterclockbool, по умолчанию: True Указывает направление отрезков, по часовой или против часовой стрелки. wedgepropsсловарь, по умолчанию: None Словарь аргументов, передаваемых объектам сектора. Например, можно передать wedgeprops = {'linewidth': 3} для установки ширины линий границ сектора равной 3. Для получения более подробной информации см. документацию по аргументам объекта сектора. По умолчанию clip_on=False. textpropsсловарь, по умолчанию: None Словарь аргументов, передаваемых текстовым объектам. center(число, число), по умолчанию: (0, 0) Координаты центра диаграммы. framebool, по умолчанию: False Если True, отображает рамку осей с диаграммой. rotatelabelsbool, по умолчанию: False Поворачивает каждую метку под углом соответствующего сектора, если True.

Возвращает:

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

Примечания

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

Этот метод устанавливает соотношение сторон осей равным. Соотношение сторон осей можно контролировать с помощью Axes.set_aspect.

Примечание

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

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

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

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