mpl_toolkits.axisartist.axis_artist.AxisArtist

class mpl_toolkits.axisartist.axis_artist.AxisArtist(axes, helper, offset=None, axis_direction='bottom', **kwargs)

基类：Artist

一种用于绘制坐标轴（第 n 个坐标轴坐标为常数的线）、刻度、刻度标签和坐标轴标签的 Artist 对象。

参数:

axesmpl_toolkits.axisartist.axislines.Axes

helperAxisArtistHelper

property LABELPAD

draw(renderer)

使用给定的渲染器绘制 Artist（及其子对象）。

如果该艺术家对象不可见（Artist.get_visible 返回 False），则此操作无效。

参数:

rendererRendererBase 子类。

备注

此方法在 Artist 子类中被覆盖。

get_axisline_style()

返回当前的坐标轴样式。

get_helper()

返回坐标轴 Artist 辅助实例。

get_tightbbox(renderer=None)

获取美工对象在显示空间中的边界框，考虑裁剪。

参数:

rendererRendererBase, 可选

用于绘制图形的渲染器（即 fig.canvas.get_renderer()）。

返回:

Bbox 或 None

闭合的边界框（图形像素坐标），如果裁剪导致无交集则返回 None。

另请参阅

Artist.get_window_extent

获取美工边界框，忽略裁剪。

get_transform()

返回此 Artist 使用的 Transform 实例。

invert_ticklabel_direction()

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, axis_direction=<UNSET>, axislabel_direction=<UNSET>, axisline_style=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, ticklabel_direction=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

一次性设置多个属性。

a.set(a=A, b=B, c=C)

等同于

a.set_a(A)
a.set_b(B)
a.set_c(C)

除全名属性外，还支持别名，例如 set(lw=2) 等同于 set(linewidth=2)，但同时传入两者会报错。

各个 setter 的调用顺序与 set() 中的参数顺序一致。然而，大多数属性并不相互依赖，因此顺序通常无关紧要。

支持的属性包括：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
axis_direction	{"left", "bottom", "right", "top"}
axislabel_direction (坐标轴标签方向)	{"+", "-"}
axisline_style (坐标轴线样式)	str 或 None
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
figure	Figure 或 SubFigure
gid	str
in_layout	布尔值
label	未知
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
ticklabel_direction (刻度标签方向)	{"+", "-"}
transform	变换
url	str
visible	布尔值
zorder	浮点数

set_axis_direction(axis_direction)

按照 Matplotlib 矩形坐标轴的惯例，调整刻度标签和坐标轴标签的方向、文本角度及文本对齐方式。

axis_direction 必须是 [left, right, bottom, top] 中的一个。

属性	左	下	右	上
刻度标签方向	"-"	"+"	"+"	"-"
坐标轴标签方向	"-"	"+"	"+"	"-"
刻度标签角度	90	0	-90	180
刻度标签垂直对齐	居中	基线	居中	基线
刻度标签水平对齐	右	居中	右	居中
轴标签角度	180	0	0	180
轴标签垂直对齐	居中	上	居中	下
轴标签水平对齐	右	居中	右	居中

请注意，方向 "+" 和 "-" 是相对于坐标增加的方向而言的。此外，文本角度实际上是相对于（90 + 指向刻度标签的方向的角度），对于底部坐标轴，这给出的值为 0。

参数:

axis_direction{"left", "bottom", "right", "top"}

set_axislabel_direction(label_direction)

调整坐标轴标签的方向。

请注意，label_direction 的 '+' 和 '-' 是相对于坐标增加的方向而言的。

参数:

label_direction{"+", "-"}

set_axisline_style(axisline_style=None, **kwargs)

设置坐标轴线样式。

新样式完全由传入的属性定义。原有的样式属性将被清除。

参数:

axisline_stylestr 或 None

线条样式，例如 '->'，后面可选跟逗号分隔的属性列表。或者，属性也可以作为关键字参数提供。

如果为 None，则返回一个包含可用样式的字符串。

示例

以下两条命令是等价的

>>> set_axisline_style("->,size=1.5")
>>> set_axisline_style("->", size=1.5)

set_label(s)

设置将在图例中显示的标签。

参数:

s对象

s 将通过调用 str 转换为字符串。

set_ticklabel_direction(tick_direction)

调整刻度标签的方向。

请注意，tick_direction 的 '+' 和 '-' 是相对于坐标增加的方向而言的。

参数:

tick_direction{"+", "-"}

toggle(all=None, ticks=None, ticklabels=None, label=None)

切换刻度、刻度标签和（坐标轴）标签的显示状态。要关闭所有显示：

axis.toggle(all=False)

要关闭除刻度外的所有显示：

axis.toggle(all=False, ticks=True)

要开启除（坐标轴）标签外的所有显示：

axis.toggle(all=True, label=False)

zorder = 2.5

使用 mpl_toolkits.axisartist.axis_artist.AxisArtist 的示例

轴方向演示

轴方向演示

刻度标签方向

刻度标签方向

简单轴填充

简单轴填充