matplotlib.axes.Axes.indicate_inset

Axes.indicate_inset(bounds=None, inset_ax=None, *, transform=None, facecolor='none', edgecolor='0.5', alpha=0.5, zorder=None, **kwargs)

向 Axes 添加一个插入指示器。这是一个位于由 bounds 指示的位置的矩形，可以选择性地用线条将矩形连接到插入的 Axes（Axes.inset_axes）。

参数:

边界[x0, y0, 宽度, 高度], 可选

要标记的矩形的左下角，以及它的宽度和高度。如果未设置，边界将从 inset_ax 的数据限制中计算得出，该参数必须提供。

inset_ax : Axes, 可选Axes，可选

一个可选的插入轴，用于绘制连接线。两条线从指示框连接到插入轴，选择角落以避免与指示框重叠。

变换 : Transform转换

矩形坐标的变换。默认为 ax.transAxes，即 rect 的单位是相对于 Axes 的坐标。

facecolor : color, 默认值: 'none'颜色, 默认值: '无'

矩形的面颜色。

edgecolor : color, 默认值: '0.5'颜色，默认值：'0.5'

矩形的颜色和连接线的颜色。

alpha浮点数或无, 默认值: 0.5

矩形和连接线的透明度。如果值不是 None ，这将覆盖 facecolor 和 edgecolor 参数中包含的任何 alpha 值。

zorderfloat, 默认值: 4.99

矩形和连接线的绘制顺序。默认值4.99，略低于内嵌Axes的默认层级。

**kwargs

其他关键字参数会传递给 Rectangle 补丁：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和图像左下角的两个偏移量
alpha	标量或无
angle	未知
animated	布尔
抗锯齿 或 aa	布尔值或无
bounds	(左, 底, 宽, 高)
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
颜色	color
edgecolor 或 ec	color or None
facecolor 或 fc	color or None
figure	Figure 或 SubFigure
填充	布尔
gid	str
hatch	{'/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
高度	未知
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
线型 或 ls	{'-', '--', '-.', ':', '', (偏移, 开关序列), ...}
linewidth 或 lw	浮点数或无
鼠标悬停	布尔
path_effects	AbstractPathEffect 的列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
宽度	未知
x	未知
xy	(浮点数, 浮点数)
y	未知
zorder	浮动

返回:

inset_indicatorinset.InsetIndicator

一个包含

inset_indicator.rectangle矩形

指示框。

inset_indicator.connectors : 由 patches.ConnectionPatch 组成的 4-tuple4元组

连接到 inset_ax 的四个角落（左下、左上、右下、右上）的四条连接线。其中两条线的可见性设置为 False，但如果用户认为自动选择不正确，可以将其可见性设置为 True。

在 3.10 版本发生变更: 之前返回的是矩形和连接器元组。

警告

此方法自3.0版本起为实验性功能，API可能会发生变化。