Matplotlib is a library in Python and it is numerical – mathematical extension for NumPy library. Pyplot is a state-based interface to a Matplotlib module which provides a MATLAB-like interface.
matplotlib.pyplot.errorbar() Function:
The errorbar() function in pyplot module of matplotlib library is used to plot y versus x as lines and/or markers with attached errorbars.
Syntax: 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)
Parameters: This method accept the following parameters that are described below:
- x, y: These parameter are the horizontal and vertical coordinates of the data points.
- fmt: This parameter is an optional parameter and it contains the string value.
- xerr, yerr: These parameter contains an array.And the error array should have positive values.
- ecolor: This parameter is an optional parameter. And it is the color of the errorbar lines with default value NONE.
- elinewidth: This parameter is also an optional parameter. And it is the linewidth of the errorbar lines with default value NONE.
- capsize: This parameter is also an optional parameter. And it is the length of the error bar caps in points with default value NONE.
- barsabove: This parameter is also an optional parameter. It contains boolean value True for plotting errorsbars above the plot symbols.Its default value is False.
- lolims, uplims, xlolims, xuplims: These parameter are also an optional parameter. They contain boolean values which is used to indicate that a value gives only upper/lower limits.
- errorevery: This parameter is also an optional parameter. They contain integer values which is used to draws error bars on a subset of the data.
Returns: This returns the container and it is comprises of the following:
- plotline:This returns the Line2D instance of x, y plot markers and/or line.
- caplines:This returns the tuple of Line2D instances of the error bar caps.
- barlinecols:This returns the tuple of LineCollection with the horizontal and vertical error ranges.
Below examples illustrate the matplotlib.pyplot.errorbar() function in matplotlib.pyplot:
Example #1:
# Implementation of matplotlib function import numpy as np import matplotlib.pyplot as plt # example data xval = np.arange( 0.1 , 4 , 0.5 ) yval = np.exp( - xval) plt.errorbar(xval, yval, xerr = 0.4 , yerr = 0.5 ) plt.title( 'matplotlib.pyplot.errorbar() function Example' ) plt.show() |
Output:
Example #2:
# Implementation of matplotlib function import numpy as np import matplotlib.pyplot as plt fig = plt.figure() x = np.arange( 10 ) y = 3 * np.sin(x / 20 * np.pi) yerr = np.linspace( 0.05 , 0.2 , 10 ) plt.errorbar(x, y + 7 , yerr = yerr, label = 'Line1' ) plt.errorbar(x, y + 5 , yerr = yerr, uplims = True , label = 'Line2' ) plt.errorbar(x, y + 3 , yerr = yerr, uplims = True , lolims = True , label = 'Line3' ) upperlimits = [ True , False ] * 5 lowerlimits = [ False , True ] * 5 plt.errorbar(x, y, yerr = yerr, uplims = upperlimits, lolims = lowerlimits, label = 'Line4' ) plt.legend(loc = 'upper left' ) plt.title('matplotlib.pyplot.errorbar()\ function Example') plt.show() |
Output: