Python中的 Matplotlib.axes.Axes.hlines()

Matplotlib.axes.Axes.hlines() 方法用于在 Axes 实例中的水平方向绘制一组水平线。

语法

Axes.hlines(y, xmin, xmax, colors=None, linestyles='-', label='', **kwargs)

参数说明

• y：float 或一个 N 个元素的数组，指定水平线的 y 坐标。
• xmin：float 或一个 N 个元素的数组，指定水平线的开始 x 坐标（左端点）。
• xmax：float 或一个 N 个元素的数组，指定水平线的结束 x 坐标（右端点）。
• colors：水平线的颜色或颜色列表。
• linestyles：水平线的线条样式，可取值为 '-'（实线）、'--'（虚线）、'-.'（点划线）、':'（点线）。
• label：仅用于图例，指定水平线的标签。
• **kwargs：其他关键字参数，可用于设置水平线的样式、标签等。

示例

import matplotlib.pyplot as plt

# 生成数据
x = [1, 2, 3, 4, 5]
y = [2, 3, 1, 5, 4]

# 绘制散点图
plt.scatter(x, y)

# 绘制水平线
plt.gca().hlines(3, 0, 5, colors='r', linestyles='--')

plt.show()

该示例代码会生成一个散点图，并在 y=3 的位置绘制一条红色虚线，其效果如下所示：

返回值

该方法没有返回值，将直接在 Axes 实例中绘制水平线。