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с горизонтальными и вертикальными областями ошибок.
- plotline: экземпляр
Другие параметры: - **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функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alphaскаляр или None animatedbool antialiasedили aabool clip_boxBboxclip_onbool clip_pathОбъект Patch или (Path, Transform) или None colorили cцвет containsнеизвестно dash_capstyleCapStyleили {'butt', 'projecting', 'round'}dash_joinstyleJoinStyleили {'miter', 'round', 'bevel'}dashesпоследовательность чисел с плавающей точкой (чернила/пробел в точках) или (None, None) dataмассив (2, N) или два одномерных массива drawstyleили ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default' figureFigurefillstyle{'full', 'left', 'right', 'bottom', 'top', 'none'} gidстрока (str) in_layoutbool labelобъект linestyleили ls{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidthили lwчисло с плавающей точкой (float) markerстрока стиля маркера, PathилиMarkerStylemarkeredgecolorили mecцвет markeredgewidthили mewчисло с плавающей точкой (float) markerfacecolorили mfcцвет markerfacecoloraltили mfcaltцвет markersizeили msчисло с плавающей точкой (float) markeveryNone или int или (int, int) или срез (slice) или список [int] или число с плавающей точкой (float) или (float, float) или список [bool] path_effectsAbstractPathEffectpickerчисло с плавающей точкой (float) или вызываемый объект [[Artist, Event], кортеж [bool, dict]] pickradiusчисло с плавающей точкой (float) rasterizedbool sketch_params(масштаб: float, длина: float, случайность: float) snapbool или None solid_capstyleCapStyleили {'butt', 'projecting', 'round'}solid_joinstyleJoinStyleили {'miter', 'round', 'bevel'}transformmatplotlib.transforms.Transformurlстрока (str) visiblebool xdataодномерный массив ydataодномерный массив zorderчисло с плавающей точкой (float)
Примечания
Примечание
Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками
s, которые интерпретируются какdata[s](если это не приводит к исключению): x, y, xerr, yerr.Объекты, передаваемые в качестве data, должны поддерживать доступ к элементам (
data[s]) и проверку на вхождение (s in data).
Примеры использования matplotlib.axes.Axes.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.axes.Axes.errorbar.html