matplotlib.axes.Axes.boxplot

Axes.boxplot(x, notch=None, sym=None, vert=None, 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)[source]

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

Прямоугольник диаграммы размаха простирается от первого квартиля (Q1) до третьего квартиля (Q3) данных, с линией на медиане. Усы простираются от прямоугольника до наиболее удалённой точки данных, находящейся в пределах 1,5 раз межквартильного размаха (IQR) от прямоугольника. Точки-выбросы — это точки, лежащие за пределами усов. Смотрите https://ru.wikipedia.org/wiki/%D0%94%D0%B8%D0%B0%D0%B3%D1%80%D0%B0%D0%BC%D0%B0_%D1%80%D0%B0%D0%B7%D0%BC%D0%B0%D1%85%D0%B0 для справки.

     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). Выемки представляют собой доверительный интервал (ДИ) для медианы. Документация для bootstrap описывает, как по умолчанию вычисляются позиции выемок, но их можно переопределить, установив параметр conf_intervals.

Примечание

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

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

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

vertbool, по умолчанию: rcParams["boxplot.vertical"] (по умолчанию: True)

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

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 (см. ниже). Не рекомендуется, если также включено shownotches. В противном случае среднее значение будет отображаться как точки.

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

Z-порядок диаграммы размаха.

Возвращает:

словарь

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

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

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

showcapsbool, default: rcParams["boxplot.showcaps"] (default: True)

Показывать концы усов.

showboxbool, default: rcParams["boxplot.showbox"] (default: True)

Показывать центральную область.

showfliersbool, default: rcParams["boxplot.showfliers"] (default: True)

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

showmeansbool, default: rcParams["boxplot.showmeans"] (default: False)

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

cappropsdict, default: None

Стиль концов.

capwidthsfloat or array, default: None

Ширина концов.

boxpropsdict, default: None

Стиль области.

whiskerpropsdict, default: None

Стиль усов.

flierpropsdict, default: None

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

medianpropsdict, default: None

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

meanpropsdict, default: None

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

labelstr or list of str, optional

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

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

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

dataindexable object, optional

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

См. также

Axes.bxp

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

violinplot

Отрисовка оценки функции плотности вероятности.

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

Настройка элементов в диаграммах размаха

Настройка элементов в диаграммах размаха

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

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

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

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

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

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

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

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

boxplot(X)

boxplot(X)