Python matplotlib QuadMesh用法及代码示例

本文简要介绍 python 语言中 matplotlib.collections.QuadMesh 的用法。

用法

class matplotlib.collections.QuadMesh(coordinates, *, antialiased=True, shading='flat', **kwargs)

基础：_MeshData，Collection

用于高效绘制四边形网格的类。

四边形网格是由 M × N 个相邻四边形组成的网格，这些四边形通过 (M+1, N+1) 顶点网格定义。四边形 (m, n) 由顶点定义

(m+1, n) ----------- (m+1, n+1)
      /                   /
     /                 /
    /               /
(m, n) -------- (m, n+1)

网格不必是规则的，多边形不必是凸的。

参数：

coordinates (M+1, N+1, 2) 类似数组

顶点。 coordinates[m, n] 指定顶点 (m, n) 的 (x, y) 坐标。

antialiased 布尔值，默认值：真

shading {'flat', 'gouraud'}，默认：'flat'

注意

与其他Collection不同，QuadMesh的默认pickradius为0，即 contains 检查测试点是否在任何网格四边形内。

参数：

edgecolors 颜色或颜色列表，默认：rcParams["patch.edgecolor"](默认：'black')

构成集合的每个补丁的边颜色。可以传递特殊值'face' 以使边颜色与面颜色匹配。

facecolors 颜色或颜色列表，默认：rcParams["patch.facecolor"](默认：'C0')

组成集合的每个补丁的面颜色。

linewidths 浮点数或浮点数列表，默认值：rcParams["patch.linewidth"](默认值：1.0)

组成集合的每个补丁的线宽。

linestyles str 或元组或其列表，默认：'solid'

有效字符串为 ['solid', 'dashed', 'dashdot', 'dotted'、'-'、'--'、'-.'、':']。破折号元组应采用以下形式：

(offset, onoffseq),

其中onoffseq 是以点为单位的开和关墨水长度的偶数长度元组。例如，请参阅线条样式。

capstyle CapStyle - 类似，默认值：rcParams["patch.capstyle"]

用于为集合中的所有路径设置线的样式。允许的值为 {'butt', 'projecting', 'round'}。

joinstyle JoinStyle - 类似，默认值：rcParams["patch.joinstyle"]

用于连接集合中所有路径的线条的样式。允许的值为 {'miter', 'round', 'bevel'}。

antialiaseds 布尔或布尔列表，默认：rcParams["patch.antialiased"](默认：True)

是否应使用抗锯齿绘制集合中的每个补丁。

offsets (float, float) 或其列表，默认：(0, 0)

渲染后翻译每个补丁的向量(默认为无翻译)。平移是在屏幕(像素)坐标中执行的(即在应用艺术家的变换之后)。

offset_transform Transform ，默认： IdentityTransform

在使用每个 offsets 向量之前将其应用于单个变换。

cmap, norm

数据标准化和颜色映射参数。有关详细说明，请参阅 ScalarMappable 。

hatch str，可选

填充路径中使用的填充图案(如果有)。有效字符串为 ['/'、''、'|'、'-'、'+'、'x', 'o'、'O'、'.'、'*']。有关每种影线类型的含义，请参阅影线样式参考。

pickradius 浮点数，默认值：5.0

如果 pickradius <= 0 ，则每当测试点位于由集合中路径的控制点形成的多边形之一内部时，Collection.contains 将返回 True。另一方面，如果它大于 0，则我们检查测试点是否包含在集合中任何路径后面的宽度为 2*pickradius 的笔划中。

urls str 列表，默认值：无

绘制后要链接到的每个补丁的 URL。目前仅适用于 SVG 后端。有关示例，请参阅超链接。

zorder 浮点数，默认值：1

绘图顺序，由集合中的所有补丁共享。有关所有默认值和示例，请参阅 Zorder 演示。