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://en.wikipedia.org/wiki/Box_plot для справки.

     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

zorder диаграммы размаха.

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

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.pyplot.boxplot

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

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

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

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

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

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

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

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