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)

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

Построение графика 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` горизонтальные и вертикальные диапазоны погрешностей.
Другие параметры:

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 :

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

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’ \| (смещение, последовательность включения/выключения штрихов) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'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 из int \| срез \| список/массив из int \| вещественное число \| кортеж длины 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’.