matplotlib.pyplot.axvline — Matplotlib 3.10.3 documentation (original) (raw)
matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, **kwargs)[source]#
Add a vertical line spanning the whole or fraction of the Axes.
Note: If you want to set y-limits in data coordinates, usevlines instead.
Parameters:
xfloat, default: 0
x position in data coordinates.
yminfloat, default: 0
The start y-position in axes coordinates. Should be between 0 and 1, 0 being the bottom of the plot, 1 the top of the plot.
ymaxfloat, default: 1
The end y-position in axes coordinates. Should be between 0 and 1, 0 being the bottom of the plot, 1 the top of the plot.
Returns:
A Line2D specified via two points (x, ymin), (x, ymax). Its transform is set such that x is indata coordinates and y is inaxes coordinates.
This is still a generic line and the vertical character is only realized through using identical x values for both points. Thus, if you want to change the x value later, you have to provide two values line.set_xdata([3, 3]).
Other Parameters:
**kwargs
Valid keyword arguments are Line2D properties, except for 'transform':
See also
Add vertical lines in data coordinates.
Add a vertical span (rectangle) across the axis.
Add a line with an arbitrary slope.
Notes
Examples
- draw a thick red vline at x = 0 that spans the yrange:
axvline(linewidth=4, color='r')
- draw a default vline at x = 1 that spans the yrange:
- draw a default vline at x = .5 that spans the middle half of the yrange:
axvline(x=.5, ymin=0.25, ymax=0.75)