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, tick_labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_ticks=True, autorange=False, zorder=None, capwidths=None, label=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, по умолчанию: rcParams["boxplot.notch"] (по умолчанию: False)

Определяет, строить ли диаграмму размаха с выемками (True) или прямоугольную диаграмму размаха (False). Выемки представляют собой доверительный интервал (ДИ) вокруг медианы. Документация для bootstrap описывает, как по умолчанию вычисляются положения выемок, но их положения также можно переопределить, задав параметр conf_intervals.

Примечание

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

symстрока, необязательно

Символ по умолчанию для точек-выбросов. Пустая строка ('') скрывает точки-выбросы. Если None, то точки-выбросы по умолчанию будут 'b+'. Более подробный контроль предоставляется параметром flierprops.

vertbool, по умолчанию: rcParams["boxplot.vertical"] (по умолчанию: 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, по умолчанию: rcParams["boxplot.patchartist"] (по умолчанию: False)

Если False создает прямоугольники с помощью объекта Line2D. В противном случае, прямоугольники рисуются с помощью объектов Patch.

tick_labelsсписок строк, необязательно

Метки для каждой диаграммы размаха. Отметки всегда размещаются в позициях positions. Если tick_labels задан, отметки подписываются соответствующим образом. В противном случае они сохраняют свои числовые значения.

Изменено в версии 3.9: Переименовано из labels, которое устарело с версии 3.9 и будет удалено в версии 3.11.

manage_ticksbool, по умолчанию: True

Если True, расположение и метки отметки будут скорректированы для соответствия положениям диаграмм размаха.

autorangebool, по умолчанию: False

Когда True и данные распределены таким образом, что 25-й и 75-й процентили равны, whis устанавливается в (0, 100), так что усы охватывают минимальное и максимальное значения данных.

meanlinebool, по умолчанию: rcParams["boxplot.meanline"] (по умолчанию: False)

Если True (и showmeans равно True), будет пытаться отобразить среднее значение как линию, охватывающую всю ширину прямоугольника в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также равно True. В противном случае, средние значения будут показаны в виде точек.

zorderfloat, по умолчанию: Line2D.zorder = 2

Z-порядок диаграммы размаха.

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

словарь

Словарь, сопоставляющий каждый компонент диаграммы размаха с списком созданных экземпляров Line2D. Этот словарь имеет следующие ключи (предполагая вертикальную диаграмму размаха):

• boxes: основной прямоугольник диаграммы размаха, показывающий квантили и доверительные интервалы медианы, если они включены.
• medians: горизонтальные линии в медиане каждого прямоугольника.
• whiskers: вертикальные линии, простирающиеся до наиболее крайних, не являющихся выбросами, точек данных.
• caps: горизонтальные линии в конце усов.
• fliers: точки, представляющие данные, выходящие за пределы усов (точки-выбросы).
• means: точки или линии, представляющие среднее значение.

Другие параметры:

showcapsbool, default: rcParams["boxplot.showcaps"] (default: True)

Показывать концы усов.

showboxbool, default: rcParams["boxplot.showbox"] (default: True)

Показывать центральный ящик.

showfliersbool, default: rcParams["boxplot.showfliers"] (default: True)

Показывать выбросы за пределами концов.

showmeansbool, default: rcParams["boxplot.showmeans"] (default: False)

Показывать средние арифметические.

cappropsdict, default: None

Стиль концов.

capwidthsfloat or array, default: None

Ширина концов.

boxpropsdict, default: None

Стиль ящика.

whiskerpropsdict, default: None

Стиль усов.

flierpropsdict, default: None

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

medianpropsdict, default: None

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

meanpropsdict, default: None

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

labelstr or list of str, optional

Метки легенды. Используйте одну строку, когда все ящики имеют одинаковый стиль и вам нужна только одна запись в легенде для них. Используйте список строк, чтобы пометить каждый ящик индивидуально. Для различимости ящики должны быть стилизованы индивидуально, что в настоящее время возможно только путем изменения возвращаемых объектов, см. например, Диаграммы размаха.

В случае одной строки запись в легенде фактически будет связана только с первым ящиком. По умолчанию легенда будет показывать линию медианы (result["medians"]); если patch_artist имеет значение True, легенда будет отображать объекты Patch (result["boxes"]) вместо этого.

Добавлена в версии 3.9.

dataindexable object, optional

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

См. также

Axes.bxp

Отображает диаграмму размаха по предварительно рассчитанным статистическим данным.

violinplot

Отображает оценку функции плотности вероятности.

Примечания

Примечание

Это обертка pyplot для axes.Axes.boxplot.

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

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

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

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

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

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

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

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

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