matplotlib.axes.Axes.axhspan() in Python

Matplotlib is a library in Python and it is numerical - mathematical extension for NumPy library. The Axes Class contains most of the figure elements: Axis, Tick, Line2D, Text, Polygon, etc., and sets the coordinate system. And the instances of Axes supports callbacks through a callbacks attribute. The Axes.axhspan() function in axes module of matplotlib library is used to add a horizontal span (rectangle) across the axis.

Syntax:

Axes.axhspan(self, ymin, ymax, xmin=0, xmax=1, **kwargs)

Parameters: This method accept the following parameters that are described below:

• ymin: This parameter is the lower limit of the horizontal span in data units.
• ymax: This parameter is the upper limit of the horizontal span in data units.
• xmin: This parameter is the lower limit of the vertical span in data units.
• xmax: This parameter is the upper limit of the vertical span in data units.

Returns: This returns the Polygon.

Below examples illustrate the matplotlib.axes.Axes.axhspan() function in matplotlib.axes: Example-1: Python3

# Implementation of matplotlib function
import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots()

ax.axhspan(1.25, 1.55, facecolor ='g', alpha = 0.5)

ax.set_title('matplotlib.axes.Axes.axhspan() Example')

plt.show()

Output: Example-2: Python3

# Implementation of matplotlib function
import numpy as np
import matplotlib.pyplot as plt

t = np.arange(-2, 3, .01)
s = np.sin(np.pi * t)

fig, ax = plt.subplots()
ax.plot(t, s, color ='black')
ax.axhline(y = 1, color ='black')
ax.axvline(x = 1, color ='black')
ax.axvline(x = 0, ymin = 0.75, linewidth = 8, color ='green')
ax.axhline(y =.5, xmin = 0.25, xmax = 0.75, color ='black')

ax.axhspan(0.25, 0.75, facecolor ='0.5', alpha = 0.5)
ax.axvspan(1.25, 1.55, facecolor ='green', alpha = 0.5)

ax.set_title('matplotlib.axes.Axes.axhspan() Example')

plt.show()

Output: