Spec-Zone.ru › Matplotlib 3.0

matplotlib.axes.Axes.bxp

Axes.bxp(bxpstats, positions=None, widths=None, vert=True, patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_xticks=True, zorder=None) [source]

Функция построения графиков «ящик с усами».

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

Параметры:
bxpstats : list of dicts

Список словарей, содержащих статистику для каждого графика «ящик с усами». Необходимые ключи:

  • med: Медиана (скалярное число с плавающей точкой).
  • q1: Первый квартиль (25-й процентиль) (скалярное число с плавающей точкой).
  • q3: Третий квартиль (75-й процентиль) (скалярное число с плавающей точкой).
  • whislo: Нижняя граница нижнего уса (скалярное число с плавающей точкой).
  • whishi: Верхняя граница верхнего уса (скалярное число с плавающей точкой).

Необязательные ключи:

  • mean: Среднее значение (скалярное число с плавающей точкой). Необходимо, если showmeans=True.
  • fliers: Данные за пределами усов (последовательность чисел с плавающей точкой). Необходимо, если showfliers=True.
  • cilo & cihi: Нижние и верхние доверительные интервалы медианы. Необходимо, если shownotches=True.
  • label: Название набора данных (строка). Если доступно, оно будет использоваться в качестве метки деления для графика «ящик с усами».
positions : array-like, default = [1, 2, ..., n]

Определяет положение ящиков. Деления и пределы автоматически настраиваются для соответствия положениям.

widths : array-like, default = None

Может быть скаляром или вектором и задаёт ширину каждого ящика. По умолчанию 0.15*(distance between extreme positions), ограниченное снизу значением 0,15 и сверху значением 0,5.

vert : bool, default = False

Если True (по умолчанию), делает ящики вертикальными. Если False, делает горизонтальные ящики.

patch_artist : bool, default = False

Если False, создаёт ящики с помощью объекта Line2D. Если True, создаёт ящики с помощью объекта Patch.

shownotches : bool, default = False

Если False (по умолчанию), создаёт прямоугольный график «ящик с усами». Если True, создаёт «ящик с усами» с выемками.

showmeans : bool, default = False

Если True, включается отображение средних значений.

showcaps : bool, default = True

Если True, включается отображение крышек.

showbox : bool, default = True

Если True, включается отображение ящика.

showfliers : bool, default = True

Если True, включается отображение выбросов.

boxprops : dict or None (default)

Если указано, задаёт стиль отрисовки ящиков.

whiskerprops : dict or None (default)

Если указано, задаёт стиль отрисовки усов.

capprops : dict or None (default)

Если указано, задаёт стиль отрисовки крышек.

flierprops : dict or None (default)

Если указано, задаёт стиль отрисовки выбросов.

medianprops : dict or None (default)

Если указано, задаёт стиль отрисовки медиан.

meanprops : dict or None (default)

Если указано, задаёт стиль отрисовки средних значений.

meanline : bool, default = False

Если True (и showmeans равен True), попытается отобразить среднее значение как линию, охватывающую всю ширину ящика в соответствии с meanprops. Не рекомендуется, если shownotches также равно True. В противном случае средние значения будут показаны как точки.

manage_xticks : bool, default = True

Если функция должна изменять значения xlim и xtick.

zorder : scalar, default = None

zorder результирующего графика «ящик с усами»

Возвращаемое значение:
result : dict

Словарь, сопоставляющий каждый компонент графика «ящик с усами» со списком созданных объектов matplotlib.lines.Line2D. Этот словарь имеет следующие ключи (при вертикальных графиках «ящик с усами»):

  • boxes: основная часть графика «ящик с усами», отображающая квартили и доверительные интервалы медианы, если они включены.
  • medians: горизонтальные линии в медиане каждого ящика.
  • whiskers: вертикальные линии, простирающиеся до самых крайних, не являющихся выбросами, точек данных.
  • caps: горизонтальные линии в концах усов.
  • fliers: точки, представляющие данные, выходящие за пределы усов (выбросы).
  • means: точки или линии, представляющие средние значения.

Примеры

(Исходный код, png, pdf)

../../_images/bxp_00_00.png

(png, pdf)

../../_images/bxp_01_00.png

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.axes.Axes.bxp.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API