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不可见（Artist.get_visible 返回 False），则此操作无效。

参数:

rendererRendererBase 子类。

备注

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

get_axisline_style()

返回当前轴线样式。

get_helper()

返回轴artist辅助实例。

get_tightbbox(renderer=None)

类似于 Artist.get_window_extent，但包括任何裁剪。

参数:

rendererRendererBase 子类，可选

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

返回:

Bbox 或 None

封闭的边界框（以图形像素坐标表示）。如果剪裁导致没有交集，则返回 None。

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>)

一次性设置多个属性。

支持的属性包括：

属性	描述
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	list of 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 的示例

轴方向演示

轴方向演示

刻度标签方向

刻度标签方向

简单轴填充

简单轴填充