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с горизонтальными и вертикальными диапазонами ошибок.
- 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функция фильтра, которая принимает массив чисел с плавающей точкой (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строка in_layoutbool labelобъект linestyleили ls{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...} linewidthили lwвещественное число markerстрока стиля маркера, PathилиMarkerStylemarkeredgecolorили mecцвет markeredgewidthили mewвещественное число markerfacecolorили mfcцвет markerfacecoloraltили mfcaltцвет markersizeили msвещественное число markeveryNone или целое число или (целое число, целое число) или срез или список[целое число] или вещественное число или (вещественное число, вещественное число) или список[bool] path_effectsAbstractPathEffectpickerвещественное число или вызываемая функция [[Художник, Событие], кортеж[bool, словарь]] pickradiusвещественное число rasterizedbool sketch_params(масштаб: число, длина: число, случайность: число) snapbool или None solid_capstyleCapStyleили {'butt', 'projecting', 'round'}solid_joinstyleJoinStyleили {'miter', 'round', 'bevel'}transformmatplotlib.transforms.Transformurlстрока visiblebool xdataодномерный массив ydataодномерный массив zorderвещественное число
Примечания
Примечание
В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками
s, которые интерпретируются какdata[s](если это не вызывает исключения): x, y, xerr, yerr.Объекты, переданные как data, должны поддерживать доступ к элементам (
data[s]) и проверку на членство (s in data).
Примеры использования matplotlib.pyplot.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