matplotlib.axes.Axes.boxplot

Axes.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.5x межквартильного размаха (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, параметр whis автоматически принимает значение (0, 100) (охват всего диапазона данных), если autorange имеет значение True.

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

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: Строит оценку функции плотности вероятности.

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

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

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

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

Сравнение диаграмм размаха и скрипичных диаграмм

Раздельное вычисление и построение диаграмм размаха

boxplot(X)

matplotlib.axes.Axes.boxplot

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

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