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

Примечание

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

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

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