matplotlib.pyplot.boxplot

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

Примечание

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

symстрока, необязательно

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

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

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

whisчисло или пара чисел, по умолчанию: 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.

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

bootstrapцелое число, необязательно

Указывает, следует ли выполнить бутстрап для вычисления доверительных интервалов вокруг медианы для вдавленных ящиков. Если 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 — количество ящиков, которые должны быть нарисованы.

widthsчисло или массив

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

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

Порядок отрисовки диаграммы ящик-усы.

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

словарь

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

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

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

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

Отобразить концы усов.

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

Отобразить центральный ящик.

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

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

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

Отобразить арифметические средние.

cappropsсловарь, по умолчанию: None

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

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

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

boxpropsсловарь, по умолчанию: None

Стиль ящика.

whiskerpropsсловарь, по умолчанию: None

Стиль усов.

flierpropsсловарь, по умолчанию: None

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

medianpropsсловарь, по умолчанию: None

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

meanpropsсловарь, по умолчанию: None

Стиль среднего арифметического.

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

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

См. также

violinplot

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

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

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

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

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

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

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

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

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

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