matplotlib.axes.Axes.axline

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

添加一条无限长的直线。

直线可以通过两个点 xy1 和 xy2 定义，或者通过一个点 xy1 和一个 斜率 (slope) 定义。

该函数在“屏幕上”绘制一条直线，而不受 x 和 y 轴缩放比例的影响，因此也适用于在半对数图（semilog plots）中绘制指数衰减曲线，或在双对数图（loglog plots）中绘制幂律曲线等。然而，斜率 (slope) 仅应在线性刻度下使用；它对于其他所有刻度没有明确的几何意义，因此其行为是未定义的。对于非线性刻度，请通过点 xy1 和 xy2 来指定直线。

transform 关键字参数仅适用于点 xy1 和 xy2。斜率 (slope)（如果提供）始终位于数据坐标系中。这可以与 ax.transAxes 等结合使用，用于绘制具有固定斜率的网格线。

参数:

xy1, xy2(float, float)

直线经过的点。必须提供 xy2 或 slope 中的一个。

slopefloat, optional

直线的斜率。必须提供 xy2 或 slope 中的一个。

返回:

AxLine

其他参数:

**kwargs

有效的关键字参数（kwargs）为 Line2D 属性

属性	描述
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	浮点数

另请参阅

axhline

用于水平线

axvline

用于垂直线

示例

绘制一条经过 (0, 0) 和 (1, 1) 的粗红色直线

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

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

无限线条

无限线条

安斯库姆四重奏

安斯库姆四重奏