matplotlib.pyplot.boxplot

matplotlib.pyplot.boxplot(x, *, notch=None, sym=None, vert=None, orientation='vertical', whis=None, positions=None, widths=None, patch_artist=None, bootstrap=None, usermedians=None, conf_intervals=None, meanline=None, showmeans=None, showcaps=None, showbox=None, showfliers=None, boxprops=None, tick_labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_ticks=True, autorange=False, zorder=None, capwidths=None, label=None, data=None)[исходный код]

Построить диаграмму размаха.

Прямоугольник простирается от первого квартиля (Q1) до третьего квартиля (Q3) данных; линия внутри него обозначает медиану. «Усы» простираются от прямоугольника до наиболее удалённых точек данных, расположенных в пределах 1,5 межквартильного размаха (IQR) от него. Точки за концами усов считаются выбросами. См. справочную информацию на странице https://en.wikipedia.org/wiki/Box_plot.

     Q1-1.5IQR   Q1   median  Q3   Q3+1.5IQR
                  |-----:-----|
  o      |--------|     :     |--------|    o  o
                  |-----:-----|
flier             <----------->            fliers
                       IQR

Параметры:

xМассив или последовательность векторов.

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

notchbool, по умолчанию: rcParams["boxplot.notch"] (значение по умолчанию: False)

Определяет, строить ли диаграмму размаха с выемками (True) или прямоугольную диаграмму размаха (False). Выемки обозначают доверительный интервал (CI) для медианы. В документации к параметру bootstrap описано, как по умолчанию вычисляется положение выемок; его также можно задать с помощью параметра conf_intervals.

Примечание

Если значения CI меньше нижнего квартиля или больше верхнего квартиля, выемки будут выступать за пределы прямоугольника, придавая ему характерный «перевёрнутый» вид. Это ожидаемое поведение, согласующееся с другими пакетами для статистической визуализации.

symstr, необязательно

Символ по умолчанию для точек-выбросов. Пустая строка ('') скрывает выбросы. Если задано None, для выбросов используется символ 'b+'. Более гибкая настройка доступна с помощью параметра flierprops.

vertbool, необязательно

Устарело с версии 3.11: Вместо него используйте orientation.

Для версии 3.10 запланировано устаревание; начиная с версии 3.11 параметр будет считаться устаревшим, а в версии 3.13 будет удалён. Если он задан в период устаревания, то переопределяет параметр orientation.

Если True, диаграммы строятся вертикально. Если False — горизонтально.

orientation{'vertical', 'horizontal'}, по умолчанию: 'vertical'

Если задано значение 'horizontal', диаграммы строятся горизонтально. В противном случае они строятся вертикально.

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

whisfloat или (float, float), по умолчанию: 1.5

Положение усов.

Если задано число с плавающей точкой, нижний ус располагается у наименьшего значения данных, превышающего Q1 - whis*(Q3-Q1), а верхний — у наибольшего значения данных, меньшего Q3 + whis*(Q3-Q1), где Q1 и Q3 — первый и третий квартили. Значение по умолчанию whis = 1.5 соответствует исходному определению диаграмм размаха, предложенному Тьюки.

Если задана пара чисел с плавающей точкой, они указывают процентили, по которым строятся усы (например, (5, 95)). В частности, значение (0, 100) приводит к тому, что усы охватывают весь диапазон данных.

В особом случае, когда Q1 == Q3, если autorange равно True, значение whis автоматически устанавливается в (0, 100) (чтобы охватить весь диапазон данных).

Данные за пределами усов считаются выбросами и отображаются в виде отдельных точек.

bootstrapint, необязательно

Определяет, следует ли использовать бутстрэп для вычисления доверительных интервалов медианы в диаграммах размаха с выемками. Если bootstrap равен None, бутстрэп не выполняется, а выемки вычисляются с помощью асимптотического приближения на основе нормального распределения (см. McGill, R., Tukey, J.W. и Larsen, W.A., 1978, а также Kendall и Stuart, 1967). В противном случае bootstrap задаёт число бутстрэп-выборок медианы, используемых для определения её 95%-го доверительного интервала. Рекомендуются значения от 1000 до 10000.

usermediansподобный массиву одномерный объект, необязательно

Подобный массиву одномерный объект длины len(x). Каждая запись, не равная None, принудительно задаёт значение медианы для соответствующего набора данных. Для записей, равных None, Matplotlib вычисляет медианы обычным образом.

conf_intervalsподобный массиву объект, необязательно

Подобный массиву двумерный объект формы (len(x), 2). Каждая запись, не равная None, принудительно задаёт положение соответствующей выемки (которая отображается, только если notch равно True). Для записей, равных None, выемки вычисляются методом, заданным другими параметрами (например, bootstrap).

positionsподобный массиву объект, необязательно

Положения прямоугольников. Деления и пределы автоматически настраиваются в соответствии с этими положениями. По умолчанию используются range(1, N+1), где N — количество строящихся прямоугольников.

widthsfloat или подобный массиву объект

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

patch_artistbool, по умолчанию: rcParams["boxplot.patchartist"] (значение по умолчанию: False)

Если задано False, прямоугольники создаются с помощью художника Line2D. В противном случае они рисуются с помощью художников Patch.

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

Подписи делений для каждой диаграммы размаха. Деления всегда располагаются в точках positions прямоугольников. Если задан параметр tick_labels, делениям назначаются соответствующие подписи. В противном случае сохраняются их числовые значения.

Изменено в версии 3.9: Переименован из labels, который считается устаревшим с версии 3.9 и будет удалён в версии 3.11.

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

Если True, положения и подписи делений корректируются в соответствии с положениями диаграмм размаха.

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

Если задано True и распределение данных таково, что 25-й и 75-й процентили равны, параметр whis устанавливается в (0, 100), поэтому концы усов соответствуют минимальному и максимальному значениям данных.

meanlinebool, по умолчанию: rcParams["boxplot.meanline"] (значение по умолчанию: False)

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

zorderfloat, по умолчанию: Line2D.zorder = 2

Порядок отрисовки диаграммы размаха.

Возвращает:

dict

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

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

Другие параметры:

showcapsbool, по умолчанию: rcParams["boxplot.showcaps"] (значение по умолчанию: True)

Показывать ограничители на концах усов.

showboxbool, по умолчанию: rcParams["boxplot.showbox"] (значение по умолчанию: True)

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

showfliersbool, по умолчанию: rcParams["boxplot.showfliers"] (значение по умолчанию: True)

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

showmeansbool, по умолчанию: rcParams["boxplot.showmeans"] (значение по умолчанию: False)

Показывать средние арифметические значения.

cappropsdict, по умолчанию: None

Стиль ограничителей.

capwidthsfloat или array, по умолчанию: None

Ширина ограничителей.

boxpropsdict, по умолчанию: None

Стиль прямоугольника.

whiskerpropsdict, по умолчанию: None

Стиль усов.

flierpropsdict, по умолчанию: None

Стиль выбросов.

medianpropsdict, по умолчанию: None

Стиль медианы.

meanpropsdict, по умолчанию: None

Стиль среднего значения.

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

Подписи элементов легенды. Используйте одну строку, если все прямоугольники имеют одинаковый стиль и для них нужна одна запись в легенде. Чтобы подписать каждый прямоугольник отдельно, используйте список строк. Для различения прямоугольники следует оформить по-разному; в настоящее время это можно сделать только путём изменения возвращённых художников, см., например, Диаграммы размаха.

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

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

dataиндексируемый объект, необязательно

Если задан, все параметры также принимают строку s, которая интерпретируется как data[s], если s является ключом в data.

См. также

Axes.bxp: Построить диаграмму размаха по предварительно вычисленной статистике.
violinplot: Построить оценку функции плотности вероятности.

Примечания

Примечание

Это обёртка pyplot для axes.Axes.boxplot.

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

Настройка художников на диаграммах размаха

Диаграммы размаха с пользовательскими цветами заливки

Диаграммы размаха

Сравнение диаграмм размаха и диаграмм-скрипок

matplotlib.pyplot.boxplot

Примечания

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

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