mpl_toolkits.axisartist.axis_artist.AxisLabel

class mpl_toolkits.axisartist.axis_artist.AxisLabel(*args, axis_direction='bottom', axis=None, **kwargs)

基类：AttributeCopier, LabelBase

轴标签。继承自 Text。文本的位置会在运行时更新，因此更改文本位置无效。否则，属性可以像普通的 Text 一样更改。

要更改刻度标签与轴标签之间的填充，请使用 set_pad。

draw(renderer)

使用给定的渲染器绘制艺术家（及其子项）。

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

参数:

渲染器 : RendererBase 子类。RendererBase 子类。

注释

此方法在 Artist 子类中被重写。

get_color()

返回文本的颜色。

get_pad()

返回内部填充的点数。

更多详情请参见 set_pad。

get_ref_artist()

返回实际定义此艺术家某些属性（例如颜色）的基础艺术家。

get_text()

返回文本字符串。

get_window_extent(renderer=None)

返回包含文本的 Bbox 边界框，以显示单位表示。

除了内部使用外，这在网页上的png文件中指定可点击区域时也很有用。

参数:

渲染器渲染器，可选

需要一个渲染器来计算边界框。如果艺术家已经被绘制，渲染器会被缓存；因此，只有在第一次绘制前调用 get_window_extent 时才需要传递此参数。实际上，通常更容易先触发一次绘制，例如通过调用 draw_without_rendering 或 plt.show()。

dpi浮点数，可选

用于计算bbox的dpi值，默认为``self.get_figure(root=True).dpi``（*不是*渲染器的dpi）；如果需要匹配保存为自定义dpi值的图像区域，则应设置该值。

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, axis_direction=<UNSET>, backgroundcolor=<UNSET>, bbox=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, default_alignment=<UNSET>, default_angle=<UNSET>, fontfamily=<UNSET>, fontproperties=<UNSET>, fontsize=<UNSET>, fontstretch=<UNSET>, fontstyle=<UNSET>, fontvariant=<UNSET>, fontweight=<UNSET>, gid=<UNSET>, horizontalalignment=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linespacing=<UNSET>, math_fontfamily=<UNSET>, mouseover=<UNSET>, multialignment=<UNSET>, pad=<UNSET>, parse_math=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, rasterized=<UNSET>, rotation=<UNSET>, rotation_mode=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, text=<UNSET>, transform=<UNSET>, transform_rotates_text=<UNSET>, url=<UNSET>, usetex=<UNSET>, verticalalignment=<UNSET>, visible=<UNSET>, wrap=<UNSET>, x=<UNSET>, y=<UNSET>, zorder=<UNSET>)

一次设置多个属性。

支持的属性有

属性	描述
agg_filter	一个过滤函数，它接收一个 (m, n, 3) 的浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
alpha	标量或无
animated	布尔值
抗锯齿	布尔值
axis_direction	{"左", "底", "右", "顶"}
backgroundcolor	color
bbox	带有属性的字典用于 patches.FancyBboxPatch
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	补丁或（路径，变换）或无
颜色 或 c	color
默认对齐	{"左", "底", "右", "顶"}
默认角度	{"左", "底", "右", "顶"}
figure	Figure 或 SubFigure
fontfamily 或 family 或 fontname	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties 或 font 或 font_properties	font_manager.FontProperties 或 str 或 pathlib.Path
字体大小 或大小	float 或 {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch 或 stretch	{一个数值范围在0-1000，'超压缩'，'特压缩'，'压缩'，'半压缩'，'正常'，'半扩展'，'扩展'，'特扩展'，'超扩展'}
fontstyle 或样式	{'normal', 'italic', 'oblique'}
fontvariant 或 variant	{'normal', 'small-caps'}
fontweight 或 weight	{一个数值范围在0-1000，'超轻'，'轻'，'正常'，'常规'，'书'，'中等'，'罗马'，'半粗'，'半粗'，'半'，'粗'，'重'，'特粗'，'黑'}
gid	str
horizontalalignment 或 ha	{'left', 'center', 'right'}
in_layout	布尔值
标签	对象
行间距	浮动（字体大小的倍数）
math_fontfamily	str
鼠标悬停	布尔值
多重对齐 或 ma	{'left', 'right', 'center'}
pad	浮动
parse_math	布尔值
路径效果	AbstractPathEffect 的列表
picker	None 或 bool 或 float 或 callable
位置	(浮点数, 浮点数)
光栅化	布尔值
旋转	浮点数或 {'垂直', '水平'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
文本	对象
变换	Transform
transform_rotates_text	布尔值
url	str
usetex	bool, 默认值: rcParams["text.usetex"] (default: False)
垂直对齐 或 va	{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
可见	布尔值
wrap	布尔值
x	浮动
y	浮动
zorder	浮动

set_axis_direction(d)

根据 matplotlib 的惯例调整轴标签的文本角度和文本对齐方式。

属性	左	底部	正确	顶部
轴标签角度	180	0	0	180
轴标签 垂直对齐	中心	顶部	中心	底部
轴标签 ha	正确	中心	正确	中心

请注意，文本角度实际上是相对于（90 + 刻度标签方向的角度）的，这为底部轴提供了0度。

参数:

d{"左", "底", "右", "顶"}

set_default_alignment(d)

设置默认对齐方式。详情请参阅 set_axis_direction。

参数:

d{"左", "底", "右", "顶"}

set_default_angle(d)

设置默认角度。详情请参见 set_axis_direction。

参数:

d{"左", "底", "右", "顶"}

set_pad(pad)

设置内部填充为点数。

实际的填充将是内部填充和外部填充的总和（后者由 AxisArtist 自动设置）。

参数:

填充浮动

内部填充，单位为点。