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超过此类标准情况时，使用可能会变得有些棘手，因此建议阅读示例。

参数：

父轴matplotlib.axes.Axes

用于放置插入轴的轴。

宽度、高度浮动或 str

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

loc str，默认值：'右上角'

放置插入轴的位置。有效位置为“左上”、“中上”、“右上”、“左中”、“中”、“右中”、“左下”、“中下”、“右下”。为了向后兼容，也接受数值。详见参数loc。Legend

bbox_to_anchor元组或matplotlib.transforms.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 的宽度和/或高度以相对单位指定，则不能使用 2 元组 [left, bottom]。请注意，除非设置了bbox_transform ，否则边界框的单位将在像素坐标中进行解释。将bbox_to_anchor 与元组一起使用时，同时指定bbox_transform几乎总是有意义的. 这可能通常是轴变换 parent_axes.transAxes。

bbox_transform matplotlib.transforms.Transform，可选

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

axes_classmatplotlib.axes.Axes类型，默认值：HostAxes

新创建的插入轴的类型。

axes_kwargs字典，可选

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

财产	描述
adjustable	{'box', 'datalim'}
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
anchor	(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	布尔
aspect	{'auto', 'equal'} 或浮动
autoscale_on	布尔
autoscalex_on	未知
autoscaley_on	未知
axes_locator	可调用[[轴，渲染器]，Bbox]
axisbelow	布尔或“线”
box_aspect	浮动或无
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
facecolor或 fc	颜色
figure	Figure
frame_on	布尔
gid	字符串
in_layout	布尔
label	目的
mouseover	布尔
navigate	布尔
navigate_mode	未知
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	[左、下、宽、高] 或Bbox
prop_cycle	未知
rasterization_zorder	浮动或无
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	字符串
transform	Transform
url	字符串
visible	布尔
xbound	未知
xlabel	字符串
xlim	（底部：浮动，顶部：浮动）
xmargin	浮动大于 -0.5
xscale	未知
xticklabels	未知
xticks	未知
ybound	未知
ylabel	字符串
ylim	（底部：浮动，顶部：浮动）
ymargin	浮动大于 -0.5
yscale	未知
yticklabels	未知
yticks	未知
zorder	漂浮

边框浮动，默认值：0.5

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

返回：

inset_axes轴类

已创建插入轴对象。

笔记

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)

的示例mpl_toolkits.axes_grid1.inset_locator.inset_axes

向插入轴添加颜色条

向插入轴添加颜色条

使用插入轴控制颜色条的位置和大小

使用插入轴控制颜色条的位置和大小

插入定位器演示

插入定位器演示