matplotlib.pyplot.spy

matplotlib.pyplot.spy(Z, *, precision=0, marker=None, markersize=None, aspect='equal', origin='upper', **kwargs)

绘制二维数组的稀疏模式。

这可视化了数组中的非零值。

有两种绘图样式可用：图像和标记。两者都适用于完整数组，但只有标记样式适用于 scipy.sparse.spmatrix 实例。

图像样式

如果 marker 和 markersize 是 None，则使用 imshow。任何额外的剩余关键字参数都会传递给此方法。

标记样式

如果 Z 是一个 scipy.sparse.spmatrix 或者 marker 或 markersize 是 None，将返回一个 Line2D 对象，其中 marker 的值决定标记类型，其余的关键字参数将传递给 plot。

参数:

Z(M, N) 数组类

要绘制的数组。

精度float 或 'present', 默认: 0

如果 precision 为 0，任何非零值都将被绘制。否则，值为 \(|Z| > precision\) 的将被绘制。

对于 scipy.sparse.spmatrix 实例，你也可以传递 'present'。在这种情况下，数组中存在的任何值都将被绘制，即使它是完全为零的。

方面{'equal', 'auto', None} 或 float, 默认: 'equal'

Axes 的纵横比。此参数对于图像尤其重要，因为它决定了数据像素是否为方形。

此参数是显式调用 Axes.set_aspect 的快捷方式。更多详情请参见那里。

• 'equal': 确保宽高比为1。像素将是正方形。

• 'auto': 保持 Axes 固定，并调整纵横比以使数据适合 Axes。通常，这将导致非方形像素。

• None: 使用 rcParams["image.aspect"] (default: 'equal')。

origin : {'upper', 'lower'}, 默认值: rcParams["image.origin"] (default: 'upper'){'upper', 'lower'}, 默认:

将数组的 [0, 0] 索引放在 Axes 的左上角或左下角。通常使用 'upper' 约定来表示矩阵和图像。

返回:

AxesImage 或 Line2D

返回类型取决于绘图样式（见上文）。

其他参数:

**kwargs

支持的附加参数取决于绘图样式。

对于图像样式，您可以传递以下 imshow 的额外参数：

• cmap

• alpha

• url

• 任何 Artist 属性（传递给 AxesImage）

对于标记样式，你可以传递任何 Line2D 属性，除了 linestyle：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 的浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 的数组和两个从图像左下角开始的偏移量
alpha	标量或无
animated	布尔
抗锯齿 或 aa	布尔
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
颜色 或 c	color
dash_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
虚线	浮点数序列（开/关墨水以点为单位）或 (None, None)
数据	(2, N) 数组或两个一维数组
drawstyle 或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, 默认: 'default'
figure	Figure 或 SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	color or None
gid	str
in_layout	布尔
标签	对象
linestyle 或 ls	{'-', '--', '-.', ':', '', (偏移, 开关序列), ...}
linewidth 或 lw	float
标记	标记样式字符串，Path 或 MarkerStyle
markeredgecolor 或 mec	color
markeredgewidth 或 mew	float
markerfacecolor 或 mfc	color
markerfacecoloralt 或 mfcalt	color
markersize 或 ms	float
markevery	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
鼠标悬停	布尔
path_effects	AbstractPathEffect 列表
picker	float 或 callable[[Artist, Event], tuple[bool, dict]]
pickradius	float
光栅化	布尔
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
solid_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
transform	未知
url	str
可见	布尔
xdata	一维数组
ydata	一维数组
zorder	float

注释

备注

这是 axes.Axes.spy 的 pyplot 包装器。

使用 matplotlib.pyplot.spy 的示例

间谍演示

Spy Demos