Python matplotlib tricontourf用法及代码示例

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

用法

matplotlib.pyplot.tricontourf(*args, **kwargs)

在非结构化三角形网格上绘制轮廓区域。

调用签名：

tricontourf(triangulation, z, [levels], ...)
tricontourf(x, y, z, [levels], *, [triangles=triangles], [mask=mask], ...)

可以通过传递 Triangulation 对象作为第一个参数来指定三角形网格，也可以通过传递点 x 、 y 以及可选的 triangles 和 mask 来指定。有关这些参数的说明，请参阅 Triangulation 。如果 triangulation 或 triangles 均未给出，则动态计算三角测量。

可以按位置传递 triangles ，即 tricontourf(x, y, triangles, z, ...) 。然而，这是不鼓励的。为了更清楚起见，请通过关键字参数传递triangles。

参数：

triangulation Triangulation ，可选

已经创建的三角形网格。

x, y, triangles, mask

定义三角网格的参数。请参阅 Triangulation 。这与指定 triangulation 是互斥的。

z 类数组

绘制轮廓的高度值。 Color-mapping 由 cmap 、 norm 、 vmin 和 vmax 控制。

注意

z 中的所有值都必须是有限的。因此，必须删除 nan 和 inf 值或使用 set_mask 。

levels int 或类似数组，可选

确定等高线/区域的数量和位置。

如果 int n ，请使用 MaxNLocator ，它会尝试在 Z 的最小和最大数值之间自动选择不超过 n+1 "nice" 等高线级别。

如果是类似数组，则在指定级别绘制等高线。这些值必须按升序排列。

返回：

TriContourSet

其他参数：

colors 颜色字符串或颜色序列，可选

级别的颜色，即轮廓区域。

该序列按升序循环级别。如果序列短于级别数，则重复。

作为一种快捷方式，可以使用单一颜色字符串代替单元素列表，即 'red' 而不是 ['red'] 以使用相同颜色为所有级别着色。此快捷方式仅适用于颜色字符串，不适用于其他指定颜色的方式。

默认情况下(值 None )，将使用由 cmap 指定的颜色图。

alpha 浮点数，默认值：1

Alpha 混合值，介于 0(透明)和 1(不透明)之间。

cmap str 或 Colormap ，默认值：rcParams["image.cmap"](默认值：'viridis')

用于将标量数据映射到颜色的颜色图实例或注册的颜色图名称。

如果设置了colors，则忽略此参数。

norm str 或 Normalize ，可选

在使用 cmap 映射到颜色之前，用于将标量数据缩放到 [0, 1] 范围的归一化方法。默认情况下，使用线性缩放，将最低值映射到 0，将最高值映射到 1。

如果给出，这可以是以下之一：

• Normalize 或其子类之一的实例(请参阅颜色图归一化)。

• 比例名称，即 "linear"、"log"、"symlog"、"logit" 等之一。有关可用比例的列表，请调用 matplotlib.scale.get_scale_names() 。在这种情况下，会动态生成并实例化合适的 Normalize 子类。

如果设置了colors，则忽略此参数。

vmin, vmax 浮点数，可选

当使用标量数据并且没有显式 norm 时，vmin 和 vmax 定义颜色图覆盖的数据范围。默认情况下，颜色图覆盖所提供数据的完整值范围。当给出 norm 实例时，使用 vmin /vmax 是错误的(但使用 str norm 名称和 vmin /vmax 是可以接受的)。

如果未给出 vmin 或 vmax ，则默认颜色缩放基于 levels 。

如果设置了colors，则忽略此参数。

origin { None , 'upper', 'lower', 'image'}，默认值：无

通过指定 z[0, 0] 的位置来确定 z 的方向和准确位置。这仅在没有给出 X 、 Y 的情况下才有意义。

• None ：z[0, 0] 位于左下角的 X=0、Y=0 处。

• 'lower'：z[0, 0] 在左下角的 X=0.5，Y=0.5 处。

• 'upper'：z[0, 0] 在左上角的 X=N+0.5，Y=0.5 处。

• 'image'：使用来自 rcParams["image.origin"] 的值(默认值：'upper')。

extent (x0, x1, y0, y1)，可选

如果 origin 不是 None ，则 extent 将被解释为 imshow ：它给出外部像素边界。在这种情况下，z[0, 0]的位置是像素的中心，而不是角点。如果 origin 为 None ，则 ( x0 , y0 ) 为 z[0, 0] 的位置，( x1 , y1 ) 为 z[-1, - 的位置1]。

如果在对轮廓的调用中指定了 X 和 Y，则忽略此参数。

locator ticker.Locator 子类，可选

如果未通过 levels 明确给出，则定位器用于确定轮廓级别。默认为 MaxNLocator 。

extend {'neither', 'both', 'min', 'max'}，默认：'neither'

确定 levels 范围之外的值的 tricontourf 着色。

如果是'neither'，则levels 范围之外的值不着色。如果是'min', 'max' 或'both'，为levels 范围的下方、上方或下方和上方的值着色。

低于 min(levels) 和高于 max(levels) 的值映射到 Colormap 的低于/高于值。请注意，默认情况下，大多数颜色图没有专门的颜色，因此上值和下值是颜色图的边值。您可能希望使用 Colormap.set_under 和 Colormap.set_over 显式设置这些值。

注意

如果现有 TriContourSet 的颜色图属性发生更改，则不会收到通知。因此，修改颜色图后需要显式调用 ContourSet.changed() 。如果将颜色条分配给 TriContourSet ，则可以省略显式调用，因为它在内部调用 ContourSet.changed() 。

xunits, yunits 注册单位，可选

通过指定 matplotlib.units.ConversionInterface 的实例来覆盖轴单位。

antialiased 布尔型，可选

启用抗锯齿，覆盖默认值。对于填充轮廓，默认值为 True 。对于线条轮廓，它取自 rcParams["lines.antialiased"](默认值：True)。

hatches 列表[str]，可选

用于填充区域的剖面线图案列表。如果无，则不会向轮廓添加阴影线。仅 PostScript、PDF、SVG 和 Agg 后端支持剖面线。

注意

tricontourf 填充顶部闭合的区间；也就是说，对于边界 z1 和 z2 ，填充区域为：

z1 < Z <= z2

除了最低间隔，它在两边都是封闭的(即它包括最低值)。