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, *, data=None)[source]

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

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

Параметры:	xМассив или последовательность векторов. Входные данные. notchbool, по умолчанию: False Определяет, рисовать ли диаграмму размаха с выемкой (True), или прямоугольную диаграмму размаха (False). Выемки представляют доверительный интервал (ДИ) вокруг медианы. Документация для bootstrap описывает, как вычисляются позиции выемок по умолчанию, но их можно переопределить, задав параметр conf_intervals. Примечание В тех случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут выходить за пределы ящика, придавая ему характерный «перевернутый» вид. Это ожидаемое поведение и соответствует другим пакетам статистической визуализации. symstr, необязательно Символ по умолчанию для точек-выбросов. Пустая строка ('') скрывает точки-выбросы. Если None, то точки-выбросы по умолчанию равны 'b+'. Более подробный контроль предоставляется параметром flierprops. vertbool, по умолчанию: True Если True, рисует вертикальные ящики. Если False, рисует горизонтальные ящики. whisfloat или (float, float), по умолчанию: 1.5 Положение усов. Если float, нижний ус находится в самой низкой точке данных выше Q1 - whis*(Q3-Q1), а верхний ус — в самой высокой точке данных ниже Q3 + whis*(Q3-Q1), где Q1 и Q3 — первый и третий квартили. Значение по умолчанию whis = 1.5 соответствует исходному определению диаграмм размаха по Туки. Если пара чисел с плавающей точкой, они указывают процентили, по которым должны быть нарисованы усы (например, (5, 95)). В частности, задание (0, 100) приводит к усам, охватывающим весь диапазон данных. В случае, когда Q1 == Q3, whis автоматически устанавливается в (0, 100) (охватывает весь диапазон данных), если autorange равно True. За пределами усов данные считаются выбросами и отображаются как отдельные точки. bootstrapint, необязательно Указывает, следует ли использовать метод бутстрепа для вычисления доверительных интервалов вокруг медианы для диаграмм размаха с выемками. Если bootstrap равно None, бутстреп не применяется, и выемки рассчитываются с использованием асимптотического приближения на основе распределения Гаусса (см. McGill, R., Tukey, J.W., and Larsen, W.A., 1978, и Kendall and Stuart, 1967). В противном случае bootstrap указывает количество раз для бутстрепа медианы для определения ее 95%-ных доверительных интервалов. Рекомендуются значения от 1000 до 10000. usermedians1D массив-подобный, необязательно 1D массив-подобный длины len(x). Каждый элемент, который не None, принудительно устанавливает значение медианы для соответствующего набора данных. Для элементов, которые None, медианы вычисляются Matplotlib по умолчанию. conf_intervalsмассив-подобный, необязательно 2D массив-подобный формы (len(x), 2). Каждый элемент, отличный от None, принудительно устанавливает положение соответствующей выемки (которая рисуется только если notch равно True). Для элементов, которые равны None, выемки вычисляются по методу, определенному другими параметрами (например, bootstrap). positionsмассив-подобный, необязательно Позиции ящиков. Отметки и пределы автоматически настраиваются для соответствия позициям. По умолчанию range(1, N+1) где N — количество ящиков, которые должны быть нарисованы. widthsfloat или массив-подобный Ширина ящиков. По умолчанию 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. В противном случае среднее значение будет показано как точки. zorderfloat, по умолчанию: Line2D.zorder = 2 zorder диаграммы размаха.
Возвращаемое значение:	dict Словарь, сопоставляющий каждый компонент диаграммы размаха со списком созданных экземпляров Line2D. Этот словарь имеет следующие ключи (при вертикальных диаграммах размаха): boxes: основное тело диаграммы размаха, показывающее квартили и доверительные интервалы медианы, если включены. medians: горизонтальные линии на медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до самых крайних точек данных, не являющихся выбросами. caps: горизонтальные линии в концах усов. fliers: точки, представляющие данные, выходящие за пределы усов (точки-выбросы). means: точки или линии, представляющие средние значения.
Другие параметры:	showcapsbool, по умолчанию: True Показать колпачки на концах усов. showboxbool, по умолчанию: True Показать центральный ящик. showfliersbool, по умолчанию: True Показать выбросы за пределами колпачков. showmeansbool, по умолчанию: False Показать средние арифметические значения. cappropsdict, по умолчанию: None Стиль колпачков. boxpropsdict, по умолчанию: None Стиль ящика. whiskerpropsdict, по умолчанию: None Стиль усов. flierpropsdict, по умолчанию: None Стиль точек-выбросов. medianpropsdict, по умолчанию: None Стиль медианы. meanpropsdict, по умолчанию: None Стиль среднего значения.

Примечания

Диаграммы размаха дают представление о свойствах распределения данных. Однако они могут быть сложными для понимания для неискушенного читателя. На рисунке ниже показаны различные визуальные элементы диаграммы размаха.

Усы обозначают диапазон данных, не являющихся выбросами. Наиболее распространенное определение невыбросов — [Q1 - 1.5xIQR, Q3 + 1.5xIQR], которое также является значением по умолчанию в этой функции. Другие значения усов могут быть заданы параметром whis.

См. Box plot в Википедии для получения дополнительной информации.

Диаграммы-смоллинги (violinplot) добавляют еще больше подробностей о статистическом распределении, строя оценки плотности ядра (KDE) в качестве оценки функции плотности вероятности.

Примечание

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

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

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

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

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

Демонстрация диаграммы размаха