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, optional (False) Если True, будет создана диаграмма «ящик с усами» с выемками. В противном случае создается прямоугольная диаграмма. Выемки представляют собой доверительный интервал (ДИ) вокруг медианы. Сведения о том, как вычисляются расположения выемок, см. в записи параметра bootstrap. Примечание В случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут выходить за пределы ящика, придавая ему характерный «перевернутый» вид. Это ожидаемое поведение и согласуется с другими статистическими пакетами визуализации. symstr, optional Символ по умолчанию для точек-выбросов. Введите пустую строку ('') если не хотите отображать точки-выбросы. Если None, то точки-выбросы по умолчанию равны 'b+'. Если требуется больший контроль, используйте параметр flierprops. vertbool, optional (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 Массив или последовательность, первая размерность (или длина) которой совместима с x. Это переопределяет медианы, вычисленные matplotlib для каждого элемента usermedians, который не равен None. Когда элемент usermedians равен None, медиана вычисляется matplotlib по умолчанию. conf_intervalsarray-like, optional Массив или последовательность, первая размерность (или длина) которой совместима с x и чья вторая размерность равна 2. Когда элемент conf_intervals не равен None, расположения выемок, вычисленные matplotlib, переопределяются (при условии, что notch равно True). Когда элемент conf_intervals равен None, выемки вычисляются методом, указанным другими параметрами (например, bootstrap). positionsarray-like, optional Устанавливает положение ящиков. Отметки и пределы автоматически устанавливаются для соответствия положению ящиков. По умолчанию range(1, N+1), где N - количество ящиков для отображения. widthsscalar or array-like Устанавливает ширину каждого ящика с помощью скаляра или последовательности. По умолчанию 0,5 или 0.15*(distance between extreme positions), если это значение меньше. patch_artistbool, optional (False) Если False создаёт ящики с помощью объекта Line2D. В противном случае ящики отображаются с помощью объектов Patch. labelssequence, optional Метки для каждого набора данных. Длина должна быть совместима с размерами x. manage_ticksbool, optional (True) Если True, позиции и метки отметок будут скорректированы для соответствия позициям ящиков. autorangebool, optional (False) Когда True и данные распределены таким образом, что 25-й и 75-й процентили равны, whis устанавливается в (0, 100) так, что усы охватывают минимальное и максимальное значения данных. meanlinebool, optional (False) Если True (и showmeans равно True), попытается отобразить среднее значение в виде линии, охватывающей всю ширину ящика в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также равно True. В противном случае среднее значение будет показано как точка. zorderscalar, optional (None) Устанавливает zorder диаграммы «ящик с усами».
Возвращает:	resultdict Словарь, сопоставляющий каждый компонент диаграммы «ящик с усами» со списком созданных объектов Line2D. Указанный словарь имеет следующие ключи (при вертикальных диаграммах): boxes: основная часть диаграммы «ящик с усами», показывающая квартили и доверительные интервалы медианы, если они включены. medians: горизонтальные линии в медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до наиболее крайних, не выходящих за пределы данных точек. caps: горизонтальные линии на концах усов. fliers: точки, представляющие данные, выходящие за пределы усов (точки-выбросы). means: точки или линии, представляющие средние значения.
Другие параметры:	showcapsbool, optional (True) Отобразить колпачки на концах усов. showboxbool, optional (True) Отобразить центральный ящик. showfliersbool, optional (True) Отобразить выбросы за пределами колпачков. showmeansbool, optional (False) Отобразить средние арифметические значения. cappropsdict, optional (None) Указывает стиль колпачков. boxpropsdict, optional (None) Указывает стиль ящика. whiskerpropsdict, optional (None) Указывает стиль усов. flierpropsdict, optional (None) Указывает стиль точек-выбросов. medianpropsdict, optional (None) Указывает стиль медианы. meanpropsdict, optional (None) Указывает стиль среднего значения.

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все ключевые аргументы.

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

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

Диаграммы «ящик с усами» с настраиваемыми цветами заливки

Диаграммы «ящик с усами»

Демонстрация диаграммы «ящик с усами»