matplotlib.axes.Axes.axline

Axes.axline(xy1, xy2=None, *, slope=None, **kwargs)

添加一条无限长的直线。

这条线可以通过两点 xy1 和 xy2 来定义，或者通过一个点 xy1 和一个 斜率 来定义。

这会在屏幕上绘制一条直线，无论 x 和 y 轴的比例如何，因此也适用于在半对数图中绘制指数衰减，在对数图中绘制幂律等。然而，slope 只应在线性比例下使用；它在所有其他比例下没有明确的意义，因此行为是未定义的。请使用点 xy1、xy2 为非线性比例指定线条。

transform 关键字参数仅适用于点 xy1, xy2。*slope*（如果给出）始终在数据坐标中。这可以与 ax.transAxes 一起使用，例如绘制具有固定斜率的网格线。

参数:

xy1, xy2(浮点数, 浮点数)

线条需要通过的点。必须给出 xy2 或 slope 中的一个。

坡度float, 可选

直线的斜率。必须给出 xy2 或 slope 中的一个。

返回:

AxLine

其他参数:

**kwargs

有效的关键字参数是 Line2D 属性

属性	描述
agg_filter	一个过滤函数，它接收一个 (m, n, 3) 的浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和图像左下角的两个偏移量
alpha	标量或无
animated	布尔
抗锯齿 或 aa	布尔
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
颜色 或 c	color
dash_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
dashes	浮点数序列（开/关墨水以点为单位）或 (None, None)
数据	(2, N) 数组或两个 1D 数组
drawstyle 或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, 默认: 'default'
figure	Figure 或 SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	color or None
gid	str
in_layout	布尔
标签	对象
linestyle 或 ls	{'-', '--', '-.', ':', '', (偏移, 开-关序列), ...}
linewidth 或 lw	float
标记	标记样式字符串, Path 或 MarkerStyle
markeredgecolor 或 mec	color
markeredgewidth 或 mew	float
markerfacecolor 或 mfc	color
markerfacecoloralt 或 mfcalt	color
markersize 或 ms	float
markevery	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
鼠标悬停	布尔
path_effects	AbstractPathEffect 列表
picker	float 或 callable[[Artist, Event], tuple[bool, dict]]
pickradius	float
光栅化	布尔
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
solid_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
transform	未知
url	str
可见	布尔
xdata	一维数组
ydata	一维数组
zorder	float

参见

axhline

水平线

axvline

垂直线条

示例

画一条穿过 (0, 0) 和 (1, 1) 的粗红线:

>>> axline((0, 0), (1, 1), linewidth=4, color='r')

使用 matplotlib.axes.Axes.axline 的示例

无限行

Infinite lines

安斯科姆四重奏

Anscombe's quartet