Python matplotlib inset_axes用法及代码示例

本文简要介绍 python 语言中 mpl_toolkits.axes_grid1.inset_locator.inset_axes 的用法。

用法

mpl_toolkits.axes_grid1.inset_locator.inset_axes(parent_axes, width, height, loc='upper right', bbox_to_anchor=None, bbox_transform=None, axes_class=None, axes_kwargs=None, borderpad=0.5)

创建具有给定宽度和高度的插入轴。

使用的两种尺寸都可以用英寸或百分比来指定。例如，：

inset_axes(parent_axes, width='40%', height='30%', loc='lower left')

在 parent_axes 左下角的插入轴中创建，其高度跨越 parent_axes 的 30% 以上的高度和 40% 以上的宽度。由于超过此类标准情况时，inset_axes 的使用可能会变得有些棘手，因此建议阅读示例。

参数：

parent_axes matplotlib.axes.Axes

用于放置插入轴的轴。

width, height 浮点数或 str

要创建的插入轴的大小。如果提供了浮标，则其尺寸以英寸为单位，例如width=1.3 。如果提供了字符串，则它是相对单位的大小，例如width='40%' 。默认情况下，即如果 bbox_to_anchor 和 bbox_transform 均未指定，则它们相对于 parent_axes。否则，它们将相对于通过 bbox_to_anchor 提供的边界框来理解。

loc str，默认值：'upper right'

放置插入轴的位置。有效位置为'upper left'、'upper center'、'upper right'、'center left'、'center'、'center right'、'lower left'、'lower center'、'lower right'。为了向后兼容，也接受数值。详情请参见 Legend 的参数loc。

bbox_to_anchor 元组或 BboxBase ，可选

插入轴将锚定到的 Bbox。如果没有，如果 bbox_transform 设置为 parent_axes.transAxes 或 parent_axes.figure.transFigure ，则使用 (0, 0, 1, 1) 的元组。否则，使用parent_axes.bbox。如果是元组，可以是 [left, bottom, width, height] 或 [left, bottom]。如果 kwargs width 和/或 height 以相对单位指定，则不能使用 2 元组 [left, bottom]。请注意，除非设置了bbox_transform，否则边界框的单位将在像素坐标中进行解释。将 bbox_to_anchor 与元组一起使用时，同时指定 bbox_transform 几乎总是有意义的。这通常可能是轴变换 parent_axes.transAxes 。

bbox_transform Transform ，可选

包含插入轴的 bbox 的转换。如果没有，则使用 transforms.IdentityTransform 。 bbox_to_anchor 的值(或其get_points 方法的返回值)由bbox_transform 转换，然后解释为像素坐标中的点(取决于dpi)。您可以在某个归一化坐标中提供 bbox_to_anchor，并给出适当的变换(例如，parent_axes.transAxes)。

axes_class Axes 类型，默认： HostAxes

新创建的插入轴的类型。

axes_kwargs 字典，可选

要传递给插入轴的构造函数的关键字参数。有效参数包括：

属性	说明
adjustable	{'box', 'datalim'}
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
anchor	(浮点数、浮点数)或 {'C'、'SW'、'S'、'SE'、'E'、'NE'、...}
animated	bool
aspect	{'auto', 'equal'} 或浮点数
autoscale_on	bool
autoscalex_on	unknown
autoscaley_on	unknown
axes_locator	可调用[[轴，渲染器]，Bbox]
axisbelow	布尔或'line'
box_aspect	浮点数或无
clip_box	BboxBase 或无
clip_on	bool
clip_path	补丁或(路径，变换)或无
facecolor 或 fc	color
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	object
mouseover	bool
navigate	bool
navigate_mode	unknown
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或可调用
position	[左、下、宽、高]或 Bbox
matplotlib.axes.Axes.set_prop_cycle	Cycler
rasterization_zorder	浮点数或无
rasterized	bool
sketch_params	(比例：浮点数，长度：浮点数，随机性：浮点数)
snap	布尔或无
subplotspec	unknown
title	str
transform	Transform
url	str
visible	bool
xbound	(下：浮点数，上：浮点数)
xlabel	str
matplotlib.axes.Axes.set_xlim	(左：浮点数，右：浮点数)
xmargin	浮点数大于 -0.5
xscale	unknown
xticklabels	unknown
xticks	unknown
ybound	(下：浮点数，上：浮点数)
ylabel	str
matplotlib.axes.Axes.set_ylim	(底部：浮点数，顶部：浮点数)
ymargin	浮点数大于 -0.5
yscale	unknown
yticklabels	unknown
yticks	unknown
zorder	float

borderpad 浮点数，默认值：0.5

插入轴和 bbox_to_anchor 之间的填充。单位是轴字体大小，即默认字体大小为 10 磅 borderpad = 0.5 相当于填充 5 磅。

返回：

inset_axes axes_class

已创建插入轴对象。

注意

bbox_to_anchor 和bbox_to_transform 的含义与图例不同。 bbox_to_anchor 的值(或其 get_points 方法的返回值；默认为 parent_axes.bbox )由 bbox_transform (默认为 Identity 转换)转换，然后解释为像素坐标中的点(即取决于 dpi)。

因此，以下三个调用是相同的，并相对于 parent_axes 创建一个插入轴：

axins = inset_axes(parent_axes, "30%", "40%")
axins = inset_axes(parent_axes, "30%", "40%",
                   bbox_to_anchor=parent_axes.bbox)
axins = inset_axes(parent_axes, "30%", "40%",
                   bbox_to_anchor=(0, 0, 1, 1),
                   bbox_transform=parent_axes.transAxes)