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. Ящик охватывает значения от нижнего до верхнего квартиля данных, с линией, представляющей медиану. Усы простираются от ящика, показывая диапазон данных. Точки-выбросы — это точки, выходящие за пределы усов.

Параметры:	xМассив или последовательность векторов. Входные данные. notchbool, по умолчанию: False Определяет, рисовать ли выемчатую диаграмму размаха (True), или прямоугольную диаграмму размаха (False). Выемки представляют собой доверительный интервал (ДИ) вокруг медианы. Документация для bootstrap описывает, как по умолчанию вычисляются позиции выемок, но их положение можно переопределить, установив параметр conf_intervals. Примечание В случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут выходить за пределы ящика, придавая ему характерный «перевернутый» вид. Это ожидаемое поведение и соответствует другим пакетам статистической визуализации. symstr, необязательно Символ по умолчанию для точек-выбросов. Пустая строка ('') скрывает точки-выбросы. Если None, то по умолчанию точки-выбросы будут 'b+'. Более тонкий контроль предоставляется параметром flierprops. vertbool, по умолчанию: True Если True, рисует вертикальные ящики. Если False, рисует горизонтальные ящики. whisfloat или (float, float), по умолчанию: 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. Точки данных за пределами усов считаются выбросами и отображаются как отдельные точки. bootstrapint, необязательно Определяет, нужно ли производить бутстрапинг доверительных интервалов вокруг медианы для выемчатых диаграмм размаха. Если bootstrap равно None, бутстрапинг не выполняется, и выемки вычисляются с использованием асимптотического приближения на основе распределения Гаусса (см. McGill, R., Tukey, J.W., and Larsen, W.A., 1978, и Kendall и 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.

См. Диаграмму размаха на Википедии для получения дополнительной информации.

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

Примечание

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

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

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