matplotlib.axes.Axes.fill_betweenx() in Python

Last Updated : 13 Apr, 2020

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.

matplotlib.axes.Axes.fill_betweenx() Function

The Axes.fill_betweenx() function in axes module of matplotlib library is used to fill the area between two vertical curves.

Syntax: Axes.fill_betweenx(self, y, x1, x2=0, where=None, step=None, interpolate=False, *, data=None, **kwargs) Parameters: This method accept the following parameters that are described below:

y: This parameter contains the y coordinates of the data points which are used to define the curves.

x1: This parameter contains the x coordinates of the data points which are used to define the first curves

x2: This parameter contains the x coordinates of the data points which are used to define the second curves. It is an optional with default value of 0.

where: This parameter is an optional parameter. And it is used to exclude some horizontal regions from being filled.

interpolate: This parameter is also an optional parameter. And it is the linewidth of the errorbar lines with default value NONE.

step: This parameter is also an optional parameter. And it is used to define if the filling should be a step function or not.

Returns: This returns a PolyCollection containing the plotted polygons.

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

Python3

# Implementation of matplotlib function
     
import numpy as np
import matplotlib.pyplot as plt
 
y = np.arange(-5, 5, 0.01)
x1 = -y * 2 + y + 10
x2 = 2 * y + y
 
fig, ax = plt.subplots()
ax.plot(y, x1, y, x2, color ='black')
ax.fill_betweenx(y, x1, x2, where = x2 >x1, 
                 facecolor ='green', alpha = 0.8)

ax.fill_betweenx(y, x1, x2, where = x2 <= x1,
                 facecolor ='black', alpha = 0.8)
 
ax.set_title('matplotlib.axes.Axes.fill_betweenx Example1')
plt.show()

Output:

Example-2:

Python3

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

y = np.arange(0.0, 2, 0.01)
x1 = np.sin(2 * np.pi * y)
x2 = 0.8 * np.sin(4 * np.pi * y)

fig, [ax1, ax2, ax3, ax4] = plt.subplots(1, 4,
                                         sharey = True,
                                         figsize =(6, 6))

ax1.fill_betweenx(y, 0, x1, facecolor ='green')
ax1.set_title('Fill_Betweenx x1 and 0')

ax2.fill_betweenx(y, x1, 1, facecolor ='green')
ax2.set_title('Fill_Betweenx x1 and 1')

ax3.fill_betweenx(y, x1, x2, facecolor ='green')
ax3.set_title('Fill_Betweenx x1 and y2')

ax4.fill_betweenx(y, x1, x2, where = x2 <= x1, 
                  facecolor ='green')

ax4.set_title('Fill_Between x1 and x2 with x2<= x1 ' )
plt.show()