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

Построить диаграмму «ящик с усами».

Ящик простирается от первого квартиля (Q1) до третьего квартиля (Q3) данных, с линией в медиане. Усы простираются от ящика на 1,5x межквартильный размах (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 artist. В противном случае ящики рисуются с помощью Patch artists.

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

Стиль колпачков.

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

Стиль ящика.

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

Стиль усов.

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

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

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

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

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

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

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

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

См. также

violinplot

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