You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 3.1.0.post1496+gb03370a04
matplotlib
Fork me on GitHub

matplotlib.pyplot.hlines

matplotlib.pyplot.hlines(y, xmin, xmax, colors='k', linestyles='solid', label='', *, data=None, **kwargs)[source]

Plot horizontal lines at each y from xmin to xmax.

Parameters:
y : scalar or sequence of scalar

y-indexes where to plot the lines.

xmin, xmax : scalar or 1D array-like

Respective beginning and end of each line. If scalars are provided, all lines will have same length.

colors : array-like of colors, optional, default: 'k'
linestyles : {'solid', 'dashed', 'dashdot', 'dotted'}, optional
label : str, optional, default: ''
Returns:
lines : LineCollection
Other Parameters:
**kwargs : LineCollection properties.

See also

vlines
vertical lines
axhline
horizontal line across the axes

Notes

Note

In addition to the above described arguments, this function can take a data keyword argument. If such a data argument is given, the following arguments are replaced by data[<arg>]:

  • All arguments with the following names: 'colors', 'xmax', 'xmin', 'y'.

Objects passed as data must support item access (data[<arg>]) and membership test (<arg> in data).