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, hold=None, data=None, **kwargs)

Построение графика с ошибками.

Построение графика x против y с ошибками в yerr и xerr. Вертикальные ошибки строятся, если yerr не равно None. Горизонтальные ошибки строятся, если xerr не равно None.

x, y, xerr и yerr могут быть скалярами, что строит одну ошибку в точке x, y.

Параметры:	x : скаляр или массив y : скаляр или массив xerr/yerr : скаляр или массив, форма (N,) или форма (2,N), необязательно Если скалярное число, массив длины N или массив длины N, ошибки рисуются на +/- значение относительно данных. По умолчанию None. Если последовательность формы 2xN, ошибки рисуются на -строка1 и +строка2 относительно данных. fmt : строка формата графика, необязательно, по умолчанию: None Символ формата графика. Если fmt — ‘none’ (регистронезависимо), рисуются только ошибки. Это используется для добавления ошибок к графику столбцов, например. По умолчанию — ‘’, пустая строка формата графика; свойства тогда идентичны значениям по умолчанию для plot(). ecolor : цвет matplotlib, необязательно, по умолчанию: None Аргумент цвета matplotlib, который задает цвет линий ошибок; если None, используется цвет линии, соединяющей маркеры. elinewidth : скаляр, необязательно, по умолчанию: None Ширина линии ошибки. Если None, используется ширина линии. capsize : скаляр, необязательно, по умолчанию: None Длина колпачков ошибок в точках; если None, принимает значение из errorbar.capsize rcParam. capthick : скаляр, необязательно, по умолчанию: None Псевдоним аргумента markeredgewidth (a.k.a. - mew). Это более осмысленное имя для свойства, которое контролирует толщину колпачка ошибки в точках. Для обратной совместимости, если mew или markeredgewidth заданы, они переопределят capthick. Это может измениться в будущих версиях. barsabove : bool, необязательно, по умолчанию: False Если True, ошибки рисуются над символами графика. По умолчанию под символами. lolims / uplims / xlolims / xuplims : bool, необязательно, по умолчанию:None Эти аргументы могут быть использованы для указания того, что значение дает только верхний/нижний предел. В этом случае используется символ каретки для обозначения этого. Аргументы lims могут быть того же типа, что и xerr и yerr. Для использования пределов с инвертированными осями, set_xlim() или set_ylim() должны быть вызваны перед errorbar(). errorevery : положительное целое число, необязательно, по умолчанию:1 подвыборка ошибок. Например, если errorevery=5, ошибки для каждого 5-го значения данных будут нарисованы. Сам график данных все равно показывает все точки данных.
Возвращаемые значения:	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 для свойств маркера: Свойство Описание agg_filter неизвестно alpha вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный) animated [True | False] antialiased или aa [True | False] clip_box экземпляр matplotlib.transforms.Bbox clip_on [True | False] clip_path [ (Path, Transform) | Patch | None ] color или c любой цвет matplotlib contains вызываемая функция dash_capstyle [‘butt’ | ‘round’ | ‘projecting’] dash_joinstyle [‘miter’ | ‘round’ | ‘bevel’] dashes последовательность включения/выключения чернил в пунктах drawstyle [‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ | ‘steps-post’] figure экземпляр matplotlib.figure.Figure fillstyle [‘full’ | ‘left’ | ‘right’ | ‘bottom’ | ‘top’ | ‘none’] gid строка-идентификатор label строка или что угодно, что можно напечатать с помощью преобразования ‘%s’. linestyle или ls [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или lw вещественное значение в пунктах marker A valid marker style markeredgecolor или mec любой цвет matplotlib markeredgewidth или mew вещественное значение в пунктах markerfacecolor или mfc любой цвет matplotlib markerfacecoloralt или mfcalt любой цвет matplotlib markersize или ms вещественное число markevery [None | int | кортеж длиной 2 из целых чисел | срез | список/массив целых чисел | вещественное число | кортеж длиной 2 из вещественных чисел] path_effects неизвестно picker расстояние в пунктах или функция выбора fn(artist, event) pickradius расстояние в пунктах rasterized [True | False | None] sketch_params неизвестно snap неизвестно solid_capstyle [‘butt’ | ‘round’ | ‘projecting’] solid_joinstyle [‘miter’ | ‘round’ | ‘bevel’] transform экземпляр matplotlib.transforms.Transform url строка url visible [True | False] xdata одномерный массив ydata одномерный массив zorder любое число

Примечания

Линии погрешности с отрицательными значениями не будут отображаться при построении на логарифмической оси.

Примечание

Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы с именами: ‘x’, ‘xerr’, ‘y’, ‘yerr’.

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

Границы погрешностей