matplotlib.axes.Axes.bxp

Axes.bxp(bxpstats, positions=None, widths=None, vert=True, patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_ticks=True, zorder=None, capwidths=None, label=None)[source]

Отображение диаграммы размаха (boxplot) по предварительно рассчитанным статистикам.

Прямоугольник диаграммы размаха простирается от первого квартиля q1 до третьего квартиля q3 данных, с линией на медиане (med). Вики-линии простираются от whislow до whishi. Точки-выбросы — это маркеры, расположенные за пределами ви-ки-линий. См. https://en.wikipedia.org/wiki/Box_plot для справки.

      whislow    q1    med    q3    whishi
                  |-----:-----|
  o      |--------|     :     |--------|    o  o
                  |-----:-----|
flier                                      fliers

Примечание

Это функция низкого уровня для отображения, когда у вас уже есть статистические параметры. Если вы хотите диаграмму размаха на основе набора данных, используйте boxplot вместо этого.

Параметры:

bxpstatsсписок словарей

Список словарей, содержащих статистику для каждой диаграммы размаха. Обязательные ключи:

• med: Медиана (скаляр).
• q1, q3: Первый и третий квартили (скаляры).
• whislo, whishi: Позиции нижней и верхней вики-линий (скаляры).

Необязательные ключи:

• mean: Среднее значение (скаляр). Необходимо, если showmeans=True.
• fliers: Данные за пределами вики-линий (массивоподобные). Необходимо, если showfliers=True.
• cilo, cihi: Нижние и верхние доверительные интервалы медианы. Необходимо, если shownotches=True.
• label: Название набора данных (строка). Если доступно, это будет использоваться в качестве метки для диаграммы размаха.

positionsмассив, по умолчанию: [1, 2, ..., n]

Позиции прямоугольников. Значения и пределы осей автоматически устанавливаются для соответствия позициям.

widthsвещественное число или массив, по умолчанию: None

Ширина прямоугольников. По умолчанию clip(0.15*(distance between extreme positions), 0.15, 0.5).

capwidthsвещественное число или массив, по умолчанию: None

Либо скаляр, либо вектор, определяющий ширину каждой крышки. По умолчанию 0.5*(width of the box), см. widths.

vertbool, по умолчанию: True

Если True (по умолчанию), прямоугольники будут вертикальными. Если False, прямоугольники будут горизонтальными.

patch_artistbool, по умолчанию: False

Если False создаёт прямоугольники с использованием объекта Line2D. Если True создаёт прямоугольники с использованием объекта Patch.

shownotches, showmeans, showcaps, showbox, showfliersbool

Отображение интервалов доверительности, средней величины (по умолчанию False), крышек, прямоугольника и выбросов (по умолчанию True).

boxprops, whiskerprops, capprops, flierprops, medianprops, meanpropsdict, необязательно

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

meanlinebool, по умолчанию: False

Если True (и showmeans равно True), будет пытаться отрисовать среднее значение как линию, покрывающую всю ширину прямоугольника согласно meanprops. Не рекомендуется, если также включено shownotches. В противном случае средние значения будут показаны в виде точек.

manage_ticksbool, по умолчанию: True

Если True, значения и метки делений будут изменены для соответствия позициям прямоугольников.

labelстрока или список строк, необязательно

Метки легенды. Используйте одну строку, когда у всех прямоугольников одинаковый стиль и вам нужна только одна запись в легенде. Используйте список строк для отдельных меток прямоугольников. Для различия прямоугольники должны иметь отдельный стиль, что в настоящее время возможно только путём изменения возвращаемых объектов, см., например, Диаграммы размаха.

В случае одной строки запись в легенде технически будет связана только с первым прямоугольником. По умолчанию легенда отобразит линию медианы (result["medians"]); если patch_artist равно True, легенда отобразит прямоугольники Patch (result["boxes"]) вместо них.

Добавлена в версии 3.9.

zorderвещественное число, по умолчанию: Line2D.zorder = 2

Зордер полученной диаграммы размаха.

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

словарь

Словарь, сопоставляющий каждый компонент диаграммы размаха с списком созданных объектов Line2D. Этот словарь имеет следующие ключи (при вертикальном отображении диаграмм размаха):

• boxes: основные тела диаграммы размаха, отображающие квартили и интервалы доверительности медианы, если они включены.
• medians: горизонтальные линии на медиане каждого прямоугольника.
• whiskers: вертикальные линии до последней точки, не являющейся выбросом.
• caps: горизонтальные линии в конце вики-линий.
• fliers: точки, представляющие данные за пределами вики-линий (выбросы).
• means: точки или линии, представляющие средние значения.

См. также

boxplot

Отобразить диаграмму размаха по данным вместо предварительно рассчитанных статистик.

Примеры использования matplotlib.axes.Axes.bxp

Отдельный расчёт и построение диаграмм размаха

Отдельный расчёт и построение диаграмм размаха