Spec-Zone.ru › Matplotlib 3.4

matplotlib.pyplot.errorbar

matplotlib.pyplot.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:

Свойство Описание
agg_filter функция фильтра, которая принимает массив чисел с плавающей точкой (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 строка
in_layout bool
label объект
linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
linewidth или lw вещественное число
marker строка стиля маркера, Path или MarkerStyle
markeredgecolor или mec цвет
markeredgewidth или mew вещественное число
markerfacecolor или mfc цвет
markerfacecoloralt или mfcalt цвет
markersize или ms вещественное число
markevery None или целое число или (целое число, целое число) или срез или список[целое число] или вещественное число или (вещественное число, вещественное число) или список[bool]
path_effects AbstractPathEffect
picker вещественное число или вызываемая функция [[Художник, Событие], кортеж[bool, словарь]]
pickradius вещественное число
rasterized bool
sketch_params (масштаб: число, длина: число, случайность: число)
snap bool или None
solid_capstyle CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle JoinStyle или {'miter', 'round', 'bevel'}
transform matplotlib.transforms.Transform
url строка
visible bool
xdata одномерный массив
ydata одномерный массив
zorder вещественное число

Примечания

Примечание

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

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

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

Errorbar limit selection

Выбор пределов для errorbar

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

Spec-Zone.ru

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