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, labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_ticks=True, autorange=False, zorder=None, *, data=None)[source]

Постройте график «ящик с усами».

Ящик простирается от первого квартиля (Q1) до третьего квартиля (Q3) данных, с линией на медиане. Усы простираются от ящика на 1,5x межквартильного размаха (IQR). Точки-выбросы — это те, что находятся за пределами усов. См. https://ru.wikipedia.org/wiki/Алгоритмический_график для справки.

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

Параметры

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

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

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

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

Примечание

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

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

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

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

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

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

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

Если float, то нижний ус находится в наименьшем значении данных, превышающем 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, по умолчанию: False

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

labelsпоследовательность, необязательно

Метки для каждого набора данных (по одному на набор).

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

Если True, положения и метки делений будут скорректированы для соответствия положениям ящиков.

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

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

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

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

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

Порядок отображения ящика.

Возвращает

dict

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

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

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

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

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

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

Показывать ли центральную часть ящика.

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

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

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

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

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

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

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

Стиль ящика.

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

Стиль усов.

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

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

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

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

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

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

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

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

См. также

violinplot

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

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