matplotlib.axes.Axes.boxplot

Axes.boxplot(self, 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]

Создать диаграмму размаха.

Создать диаграмму размаха для каждого столбца в x или каждого вектора в последовательности x. Ящик охватывает значения от нижнего до верхнего квартиля данных, с линией на медиане. Усы простираются от ящика, показывая диапазон данных. Точки-выбросы — это те, что находятся за пределами усов.

Параметры:	xArray or a sequence of vectors. Входные данные. notchbool, default: False Определяет, строить ли диаграмму с выемками ящика (True), или прямоугольную диаграмму ящика (False). Выемки представляют доверительный интервал (ДИ) вокруг медианы. Документация для bootstrap описывает, как вычисляются позиции выемок. Примечание В случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут простираться за пределы ящика, придавая ему характерный «перевернутый» вид. Это ожидаемое поведение и согласуется с другими пакетами статистической визуализации. symstr, optional Символ по умолчанию для точек-выбросов. Пустая строка ('') скрывает точки-выбросы. Если None, то точки-выбросы по умолчанию равны 'b+'. Больше контроля предоставляется параметром flierprops. vertbool, default: True Если True, строятся вертикальные ящики. Если False, строятся горизонтальные ящики. whisfloat or (float, float), default: 1.5 Положение усов. Если число с плавающей точкой, нижний ус находится в самом нижнем значении данных, большем, чем Q1 - whis*(Q3-Q1), а верхний ус — в самом верхнем значении данных, меньшем, чем Q3 + whis*(Q3-Q1), где Q1 и Q3 — первый и третий квартили. Значение по умолчанию whis = 1.5 соответствует исходному определению диаграмм размаха по Туки. Если пара чисел с плавающей точкой, они указывают процентили, в которых нужно строить усы (например, (5, 95)). В частности, установка значения (0, 100) приводит к построению усов, охватывающих весь диапазон данных. "range" — устаревшее синоним для (0, 100). В случае, когда Q1 == Q3, whis автоматически устанавливается в (0, 100) (охватывает весь диапазон данных), если autorange равно True. За пределами усов данные считаются выбросами и отображаются как отдельные точки. bootstrapint, optional Указывает, нужно ли использовать бутстрап для вычисления доверительных интервалов вокруг медианы для диаграмм с выемками ящика. Если bootstrap равно None, бутстрапинг не выполняется, и выемки вычисляются с использованием асимптотического приближения на основе Гаусса (см. McGill, R., Tukey, J.W., и Larsen, W.A., 1978, и Kendall и Stuart, 1967). В противном случае bootstrap определяет количество повторений бутстрапинга для определения 95% доверительных интервалов медианы. Рекомендуются значения от 1000 до 10000. usermediansarray-like, optional Одномерный массив-подобный длины len(x). Каждый элемент, который не None, задаёт значение медианы для соответствующего набора данных. Для элементов, равных None, медианы вычисляются Matplotlib как обычно. conf_intervalsarray-like, optional Двумерный массив-подобный формы (len(x), 2). Каждый элемент, который не None, задаёт положение соответствующей выемки (которое рисуется только если notch равен True). Для элементов, равных None, выемки вычисляются методом, указанным другими параметрами (например, bootstrap). positionsarray-like, optional Устанавливает положения ящиков. Отметки и пределы автоматически устанавливаются для соответствия положениям. По умолчанию range(1, N+1), где N — количество ящиков для построения. widthsfloat or array-like Устанавливает ширину каждого ящика с помощью скаляра или последовательности. По умолчанию 0.5 или 0.15*(distance between extreme positions), если это значение меньше. patch_artistbool, default: False Если False, создаёт ящики с помощью объекта Line2D. В противном случае, ящики строятся с помощью объектов Patch. labelssequence, optional Метки для каждого набора данных (по одному на каждый набор). manage_ticksbool, default: True Если True, позиции и метки делений будут изменены для соответствия положениям диаграмм размаха. autorangebool, default: False При значении True и распределении данных таким образом, что 25-й и 75-й процентили совпадают, whis устанавливается в (0, 100), чтобы концы усов находились в минимальном и максимальном значениях данных. meanlinebool, default: False Если True (и showmeans равно True), попытается отобразить среднее значение как линию, охватывающую всю ширину ящика в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также равно True. В противном случае среднее значение будет показано как точка. zorderfloat, default: Line2D.zorder = 2 Устанавливает z-порядок диаграммы размаха.
Возвращаемое значение:	dict Словарь, сопоставляющий каждый компонент диаграммы размаха со списком созданных объектов Line2D. Этот словарь имеет следующие ключи (предполагая вертикальные диаграммы размаха): boxes: основной элемент ящика, отображающий квартили и доверительные интервалы медианы, если они включены. medians: горизонтальные линии на медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до самых крайних, не выбросов точек данных. caps: горизонтальные линии в конце усов. fliers: точки, представляющие данные, выходящие за пределы усов (выбросы). means: точки или линии, представляющие среднее значение.
Другие параметры:	showcapsbool, default: True Показывать ли концы усов. showboxbool, default: True Показывать ли центральный ящик. showfliersbool, default: True Показывать ли выбросы за пределами усов. showmeansbool, default: False Показывать ли арифметические средние. cappropsdict, default: None Стиль концов усов. boxpropsdict, default: None Стиль ящика. whiskerpropsdict, default: None Стиль усов. flierpropsdict, default: None Стиль выбросов. medianpropsdict, default: None Стиль медианы. meanpropsdict, default: None Стиль среднего значения.

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data предоставлен, все остальные аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключения).

Объекты, переданные как data, должны поддерживать доступ по элементам (data[s]) и проверку на принадлежность (s in data).

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

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

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

Демонстрация boxplot