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)