matplotlib.inset

inset 模块定义了 InsetIndicator 类，它绘制了 Axes.indicate_inset 和 Axes.indicate_inset_zoom 所需的矩形和连接器。

class matplotlib.inset.InsetIndicator(bounds=None, inset_ax=None, zorder=None, **kwargs)

基类: Artist

用于突出显示感兴趣区域的艺术家。

内嵌指示器是图表上由 bounds 指示位置的矩形，可选择带有将矩形连接到内嵌坐标轴（Axes.inset_axes）的线条。

自 3.10 版本新增。

参数:

bounds[x0, y0, width, height], 可选

要标记的矩形的左下角、宽度和高度。如果未设置，则边界将从必须提供的 inset_ax 的数据限制计算。

inset_axAxes, 可选

一个可选的内嵌坐标轴，用于绘制连接线。绘制两条线将指示器框连接到内嵌坐标轴的角点，选择这些角点是为了不与指示器框重叠。

zorder浮点数, 默认值: 4.99

矩形和连接线的绘制顺序。默认值 4.99 略低于内嵌坐标轴的默认级别。

**kwargs

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

property connectors

由 patches.ConnectionPatch 组成的 4 元组或 None

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

draw(renderer)

使用给定的渲染器绘制 Artist（及其子对象）。

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

参数:

rendererRendererBase 子类。

备注

此方法在 Artist 子类中被覆盖。

property rectangle

Rectangle: 指示器框架。

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

一次性设置多个属性。

支持的属性包括：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	未知
animated	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color	color
edgecolor	颜色 或 None
figure	Figure 或 SubFigure
gid	str
in_layout	布尔值
label	对象
linestyle	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth	浮点数或 None
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	str
visible	布尔值
zorder	浮点数

set_alpha(alpha)

设置用于混合的alpha值 - 不支持所有后端。

参数:

alpha浮点数或 None

alpha 必须在 0-1 范围内（包含 0 和 1）。

set_color(c)

设置矩形和连接器的边缘颜色，以及矩形的填充颜色。

参数:

c颜色

set_edgecolor(color)

设置矩形和连接器的边缘颜色。

参数:

color颜色 或 None

set_linestyle(ls)

设置矩形和连接器的线条样式。

linestyle	描述
'-' 或 'solid'	实线
'--' 或 'dashed'	虚线
'-.' 或 'dashdot'	点划线
':' 或 'dotted'	点线
'none', 'None', ' ', 或 ''	不绘制任何内容

或者，可以提供以下形式的虚线元组

(offset, onoffseq)

其中 onoffseq 是一个偶数长度的元组，表示以点为单位的实线和空白长度。

参数:

ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

线条样式。

set_linewidth(w)

设置矩形和连接器的线宽（以点为单位）。

参数:

w浮点数或 None

zorder = 4.99