Python中的 Matplotlib.pyplot.axhspan()

matplotlib.pyplot.axhspan()函数是用于在图形中绘制一个水平范围条，在两个水平位置之间填充指定颜色的矩形。该函数需要4个参数：ymin，ymax，xmin和xmax。ymin和ymax是水平范围条跨越的y坐标的下限和上限。xmin和xmax定义水平范围条的x坐标的左右限制，如果未提供，则范围条将显示在整个x轴上。

语法

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

参数：

• ymin：水平范围条的y坐标下限
• ymax：水平范围条的y坐标上限
• xmin：水平范围条的x坐标下限，默认为0
• xmax：水平范围条的x坐标上限，默认为1
• **kwargs：其他可选参数，例如颜色、alpha值、边线宽度等

返回值

返回类型为matplotlib.patches.Rectangle，在图形中绘制一个水平范围条。

示例

import matplotlib.pyplot as plt

fig, ax = plt.subplots()

# 使用默认参数在整个x轴上绘制水平范围条
ax.axhspan(2, 4, color='green', alpha=0.5)

# 在x轴[0.2, 0.8]的范围内绘制水平范围条
ax.axhspan(6, 8, xmin=0.2, xmax=0.8, color='blue', alpha=0.5)

plt.show()

参数

• ymin=2，ymax=4：在y=2和y=4之间绘制水平范围条
• xmin=0，xmax=1：默认为0和1，因此在整个x轴上绘制水平范围条
• color='green'：矩形的填充颜色为绿色
• alpha=0.5：矩形的透明度为0.5

第二个axhspan()函数调用显示了如何在x轴区间的一部分内绘制水平范围条，并使用蓝色填充。这是通过设置xmin和xmax参数来完成的。

返回值

在图形中绘制了两个水平范围条。每个axhspan()调用都返回描述该范围的矩形，可以在需要时对其进行操作。例如，可以使用set_visible()函数隐藏/显示矩形：

rect1 = ax.axhspan(2, 4, color='green', alpha=0.5)
rect1.set_visible(False)

上面的代码将绿色的水平范围条隐藏起来。

总结

matplotlib.pyplot.axhspan()函数可用于在图形中绘制水平范围条，通过提供ymin、ymax、xmin和xmax参数来指定范围条的位置和大小。其他参数用于设置范围条的颜色、透明度和边框宽度。返回值为矩形对象，可以使用其属性和方法进行个性化设置。