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://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). Выемки представляют доверительный интервал (ДИ) медианы. Документация по 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., and 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.axes.Axes.boxplot

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

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

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

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

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

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

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

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

boxplot(X)

boxplot(X)