Spec-Zone.ru › Matplotlib 3.4

matplotlib.axes.Axes.errorbar

Axes.errorbar(x, y, yerr=None, xerr=None, fmt='', ecolor=None, elinewidth=None, capsize=None, barsabove=False, lolims=False, uplims=False, xlolims=False, xuplims=False, errorevery=1, capthick=None, *, data=None, **kwargs)[source]

Строит график y по x с линиями и/или маркерами и ошибками.

x и y определяют позиции данных, xerr и yerr определяют размеры области ошибок. По умолчанию отображаются как данные, так и области ошибок. Используйте fmt='none', чтобы нарисовать области ошибок без маркеров данных.

Параметры:
x, yfloat или массив-подобный объект

Позиции данных.

xerr, yerrfloat или массив-подобный объект, форма (N,) или форма (2, N), необязательно

Размеры области ошибок:

  • скаляр: Симметричные значения +/- для всех точек данных.
  • форма (N,): Симметричные значения +/- для каждой точки данных.
  • форма (2, N): Отдельные значения - и + для каждой области. Первая строка содержит нижние ошибки, вторая строка содержит верхние ошибки.
  • None: Нет области ошибок.

Обратите внимание, что все массивы ошибок должны иметь положительные значения.

См. Различные способы задания областей ошибок для примера использования xerr и yerr.

fmtстрока, по умолчанию: ''

Формат точек данных/линий данных. См. plot для подробностей.

Используйте 'none' (регистронезависимо), чтобы нарисовать области ошибок без маркеров данных.

ecolorцвет, по умолчанию: None

Цвет линий областей ошибок. Если None, используется цвет линии, соединяющей маркеры.

elinewidthfloat, по умолчанию: None

Толщина линий областей ошибок. Если None, используется толщина линии текущего стиля.

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина колпачков области ошибок в пунктах.

capthickfloat, по умолчанию: None

Псевдоним для ключевого аргумента markeredgewidth (также mew). Это более понятное название для свойства, которое управляет толщиной колпачка области ошибки в пунктах. Для обратной совместимости, если задано mew или markeredgewidth, они переопределяют capthick. Это может измениться в будущих версиях.

barsabovebool, по умолчанию: False

Если True, области ошибок отображаются над символами графика. По умолчанию — под.

lolims, uplims, xlolims, xuplimsbool, по умолчанию: False

Эти аргументы могут использоваться для указания того, что значение задаёт только верхние/нижние пределы. В этом случае используется символ каретки для обозначения этого. lims-аргументы могут быть скалярами или массив-подобными объектами той же длины, что и xerr и yerr. Для использования пределов с инвертированными осями необходимо вызвать set_xlim или set_ylim перед errorbar(). Обратите внимание на запутанные названия параметров: установка, например, lolims в True означает, что значение y является нижним пределом истинного значения, поэтому рисуется только стрелка, направленная вверх!

erroreveryint или (int, int), по умолчанию: 1

рисует области ошибок по подмножеству данных. errorevery =N рисует области ошибок для точек (x[::N], y[::N]). errorevery =(start, N) рисует области ошибок для точек (x[start::N], y[start::N]). Например, errorevery=(6, 3) добавляет области ошибок к данным в (x[6], x[9], x[12], x[15], ...). Используется для предотвращения перекрывания областей ошибок, когда две серии данных имеют общие значения на оси x.

Возвращает:
ErrorbarContainer

Контейнер содержит:

  • plotline: экземпляр Line2D маркеров и/или линии графика x, y.
  • caplines: Кортеж экземпляров Line2D колпачков области ошибок.
  • barlinecols: Кортеж LineCollection с горизонтальными и вертикальными областями ошибок.
Другие параметры:
**kwargs

Все остальные ключевые аргументы передаются в вызов plot, рисующий маркеры. Например, этот код создаёт большие красные квадраты с толстыми зелёными границами:

x, y, yerr = rand(3, 10)
errorbar(x, y, yerr, marker='s', mfc='red',
         mec='green', ms=20, mew=4)

где mfc, mec, ms и mew являются псевдонимами для более длинных имён свойств, markerfacecolor, markeredgecolor, markersize и markeredgewidth.

Действительные значения kwargs для свойств маркера — свойства Line2D.

END_OF_DOCUMENT_MARKER
Свойство Описание
agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha скаляр или None
animated bool
antialiased или aa bool
clip_box Bbox
clip_on bool
clip_path Объект Patch или (Path, Transform) или None
color или c цвет
contains неизвестно
dash_capstyle CapStyle или {'butt', 'projecting', 'round'}
dash_joinstyle JoinStyle или {'miter', 'round', 'bevel'}
dashes последовательность чисел с плавающей точкой (чернила/пробел в точках) или (None, None)
data массив (2, N) или два одномерных массива
drawstyle или ds {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
figure Figure
fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'}
gid строка (str)
in_layout bool
label объект
linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidth или lw число с плавающей точкой (float)
marker строка стиля маркера, Path или MarkerStyle
markeredgecolor или mec цвет
markeredgewidth или mew число с плавающей точкой (float)
markerfacecolor или mfc цвет
markerfacecoloralt или mfcalt цвет
markersize или ms число с плавающей точкой (float)
markevery None или int или (int, int) или срез (slice) или список [int] или число с плавающей точкой (float) или (float, float) или список [bool]
path_effects AbstractPathEffect
picker число с плавающей точкой (float) или вызываемый объект [[Artist, Event], кортеж [bool, dict]]
pickradius число с плавающей точкой (float)
rasterized bool
sketch_params (масштаб: float, длина: float, случайность: float)
snap bool или None
solid_capstyle CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle JoinStyle или {'miter', 'round', 'bevel'}
transform matplotlib.transforms.Transform
url строка (str)
visible bool
xdata одномерный массив
ydata одномерный массив
zorder число с плавающей точкой (float)

Примечания

Примечание

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

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

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

Errorbar subsampling

Подвыборка errorbar

Errorbar function

Функция errorbar

Different ways of specifying error bars

Различные способы задания погрешностей

Including upper and lower limits in error bars

Включение верхних и нижних границ в errorbar

Creating boxes from error bars using PatchCollection

Создание прямоугольников из errorbar с помощью PatchCollection

Legend Demo

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

Parasite Simple2

Parasite Simple2

3D errorbars

3D errorbar

Log Demo

Демонстрация логарифмических осей

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

Spec-Zone.ru

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