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]

Построение диаграммы размаха.

Построение диаграммы размаха для каждого столбца в 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., and Larsen, W.A., 1978, и Kendall and 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.pyplot.boxplot

Пример построения диаграммы размаха