matplotlib.pyplot.axhline

matplotlib.pyplot.axhline(y=0, xmin=0, xmax=1, **kwargs)

添加一条水平线，跨越 Axes 的全部或部分。

注意：如果想在数据坐标中设置 x 轴限制，请改用 hlines。

参数:

y浮点数，默认值: 0

y 位置，以 数据坐标 表示。

xmin浮点数，默认值：0

起始 x 位置，以 坐标轴坐标 表示。应介于 0 和 1 之间，其中 0 为图的左侧，1 为图的右侧。

xmax浮点数，默认值：1

结束 x 位置，以 坐标轴坐标 表示。应介于 0 和 1 之间，其中 0 为图的左侧，1 为图的右侧。

返回:

Line2D

一个 Line2D 对象，由两个点 (xmin, y) 和 (xmax, y) 定义。其变换设置使得 *x* 在 坐标轴坐标 中，*y* 在 数据坐标 中。

这仍然是一条通用线，其水平特性仅通过对两个点使用相同的 *y* 值来实现。因此，如果以后要更改 *y* 值，必须提供两个值，例如 line.set_ydata([3, 3])。

其他参数:

**kwargs

有效的关键字参数是 Line2D 属性，'transform' 除外。

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
antialiased 或 aa	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color 或 c	color
dash_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
dashes	浮点数序列（点中的开/关墨迹）或 (None, None)
data	(2, N) 数组或两个一维数组
drawstyle 或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
figure	Figure 或 SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	颜色 或 None
gid	str
in_layout	布尔值
label	object
linestyle 或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth 或 lw	浮点数
marker	标记样式字符串，Path 或 MarkerStyle
markeredgecolor 或 mec	color
markeredgewidth 或 mew	浮点数
markerfacecolor 或 mfc	color
markerfacecoloralt 或 mfcalt	color
markersize 或 ms	浮点数
markevery	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	浮点数或 callable[[Artist, Event], tuple[bool, dict]]
pickradius	浮点数
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
solid_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
transform	未知
url	str
visible	布尔值
xdata	一维数组
ydata	一维数组
zorder	浮点数

另请参阅

hlines

在数据坐标中添加水平线。

axhspan

沿坐标轴添加水平跨度（矩形）。

axline

添加任意斜率的线。

备注

注意

这是 pyplot 封装器，用于 axes.Axes.axhline。

示例

• 在 'y' = 0 处绘制一条跨越 x 轴范围的粗红色水平线。

  >>> axhline(linewidth=4, color='r')
  

• 在 'y' = 1 处绘制一条跨越 x 轴范围的默认水平线。

  >>> axhline(y=1)
  

• 在 'y' = 0.5 处绘制一条跨越 x 轴范围中间一半的默认水平线。

  >>> axhline(y=.5, xmin=0.25, xmax=0.75)
  

使用 matplotlib.pyplot.axhline 的示例

无限线条

无限线条

Zorder 演示

Zorder 演示