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, capwidths=None, *, data=None)[source]

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

Прямоугольник охватывает от первого квартиля (Q1) до третьего квартиля (Q3) данных, с линией на медиане. Усы простираются от прямоугольника на 1,5 * межквартильный размах (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). Выемки представляют доверительный интервал (CI) вокруг медианы. Документация для bootstrap описывает, как вычисляются положения выемок по умолчанию, но их положение также можно переопределить, задав параметр conf_intervals.

Примечание

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

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

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

vertbool, по умолчанию: 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, по умолчанию: False

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

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

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

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

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

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

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

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

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

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

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

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

dict

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

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

Дополнительные параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Стиль усов.

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

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

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

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

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

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

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

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

См. также

violinplot

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

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

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

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

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

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

Демонстрация диаграммы размаха

Демонстрация диаграммы размаха

boxplot(X)

boxplot(X)