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

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

Примечание

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

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)