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_xticks=True, autorange=False, zorder=None, hold=None, data=None)

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

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

Параметры:	x : Массив или последовательность векторов. Вводные данные. notch : bool, необязательно (False) Если True, будет построена диаграмма размаха с выемками. В противном случае, строится обычная диаграмма размаха. Выемки представляют доверительный интервал (ДИ) медианы. Сведения о вычислении расположения выемок см. в описании параметра bootstrap. Примечание В случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут выходить за пределы ящика, придавая ему характерный «перевернутый» вид. Это ожидаемое поведение, согласующееся с другими пакетами статистической визуализации. sym : str, необязательно Символ по умолчанию для точек-выбросов. Введите пустую строку (‘’) если не хотите отображать точки-выбросы. Если None, то точки-выбросы по умолчанию равны ‘b+’. Если вам нужен больший контроль, используйте параметр flierprops. vert : bool, необязательно (True) Если True (по умолчанию), ящики строятся вертикально. Если False, всё строится горизонтально. whis : float, последовательность или строка (по умолчанию = 1.5) В виде числа определяет протяжённость усов за пределами первого и третьего квартилей. Другими словами, если IQR — это межквартильный размах (Q3-Q1), верхний ус будет доходить до последнего значения данных, меньшего чем Q3 + whis*IQR). Аналогично, нижний ус будет доходить до первого значения данных, большего чем Q1 - whis*IQR. За пределами усов данные считаются выбросами и отображаются как отдельные точки. Установите это значение в неоправданно большое число, чтобы принудительно показать усы до минимального и максимального значений. В качестве альтернативы установите это значение в возрастающую последовательность перцентилей (например, [5, 95]), чтобы установить усы в соответствии со специфическими перцентилями данных. Наконец, whis может принимать значение 'range' для принудительного отображения усов до минимального и максимального значений данных. bootstrap : int, необязательно Указывает, нужно ли заново вычислять доверительные интервалы вокруг медианы для диаграмм размаха с выемками. Если bootstrap равно None, пересчёта не производится, и выемки вычисляются с помощью асимптотического приближения на основе распределения Гаусса (см. McGill, R., Tukey, J.W., и Larsen, W.A., 1978, и Kendall и Stuart, 1967). В противном случае, bootstrap указывает количество пересчётов медианы для определения её 95%-ных доверительных интервалов. Рекомендуются значения от 1000 до 10000. usermedians : массив-подобный, необязательно Массив или последовательность, первая размерность (или длина) которой совместима с x. Это переопределяет медианы, вычисленные matplotlib для каждого элемента usermedians, который не None. Когда элемент usermedians равен None, медиана вычисляется matplotlib как обычно. conf_intervals : массив-подобный, необязательно Массив или последовательность, первая размерность (или длина) которой совместима с x, а вторая размерность — 2. Когда элемент conf_intervals не равен None, расположение выемок, вычисленное matplotlib, переопределяется (при условии, что notch равно True). Когда элемент conf_intervals равен None, выемки вычисляются методом, указанным другими параметрами (например, bootstrap). positions : массив-подобный, необязательно Устанавливает положение ящиков. Отметки и пределы автоматически устанавливаются в соответствии с положением. По умолчанию это range(1, N+1), где N — число отображаемых ящиков. widths : скаляр или массив-подобный Устанавливает ширину каждого ящика либо скалярным значением, либо последовательностью. По умолчанию 0,5, или 0.15*(distance between extreme positions), если это значение меньше. patch_artist : bool, необязательно (False) Если False, создаются ящики с использованием Line2D. В противном случае, ящики строятся с помощью Patch. labels : последовательность, необязательно Метки для каждого набора данных. Длина должна быть совместима с размерами x. manage_xticks : bool, необязательно (True) Если функция должна изменять xlim и xtick. autorange : bool, необязательно (False) Когда True и данные распределены таким образом, что 25-й и 75-й перцентили равны, whis устанавливается в 'range' так, что концы усов находятся в минимуме и максимуме данных. meanline : bool, необязательно (False) Если True (и showmeans равно True), будет предпринята попытка отобразить среднее значение как линию, охватывающую всю ширину ящика в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также True. В противном случае средние значения будут показаны как точки. zorder : скаляр, необязательно (None) Устанавливает z-порядок диаграммы размаха.
Возвращаемое значение:	result : dict Словарь, сопоставляющий каждый компонент диаграммы размаха со списком созданных matplotlib.lines.Line2D объектов. Этот словарь содержит следующие ключи (предполагается построение вертикальных диаграмм размаха): boxes: основное тело диаграммы размаха, отображающее квартили и доверительные интервалы медианы, если они включены. medians: горизонтальные линии в медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до самых крайних, не являющихся выбросами, точек данных. caps: горизонтальные линии в концах усов. fliers: точки, представляющие данные, выходящие за пределы усов (выбросы). means: точки или линии, представляющие средние значения. Примечание Помимо вышеперечисленных аргументов, данная функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]: Все позиционные и все ключевые аргументы.
Другие параметры:
	showcaps : bool, необязательно (True) Показывать концы усов. showbox : bool, необязательно (True) Показывать центральный ящик. showfliers : bool, необязательно (True) Показывать выбросы за пределами концов усов. showmeans : bool, необязательно (False) Показывать средние арифметические значения. capprops : dict, необязательно (None) Устанавливает стиль концов усов. boxprops : dict, необязательно (None) Устанавливает стиль ящика. whiskerprops : dict, необязательно (None) Устанавливает стиль усов. flierprops : dict, необязательно (None) Устанавливает стиль выбросов. medianprops : dict, необязательно (None) Устанавливает стиль медианы. meanprops : dict, необязательно (None) Устанавливает стиль среднего значения.