matplotlib.axes.Axes.tricontourf #

轴。tricontourf ( * args , ** kwargs ) [来源] #

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

来电签名：

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

Triangulation 可以通过将对象作为第一个参数传递，或者通过传递点x、y以及可选的三角形和掩码来指定三角形网格。有关这些参数的说明，请参阅Triangulation。如果三角剖分或 三角形都没有给出，三角剖分是即时计算的。

可以按位置传递三角形，即 . 但是，这是不鼓励的。为了更清楚，通过关键字参数传递三角形。tricontourf(x, y, triangles, Z, ...)

参数：

三角测量Triangulation，可选

已经创建的三角形网格。

x, y, 三角形, 蒙版

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

Z阵列状

绘制轮廓的高度值。颜色映射由cmap、norm、vmin和vmax控制。

级别int 或类似数组，可选

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

如果是 int n，请使用，它会尝试在vmin和vmaxMaxNLocator之间自动选择不超过n+1 个“nice”等高线级别。

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

返回：

TriContourSet

其他参数：

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

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

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

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

默认情况下（值None），将使用cmap指定的颜色图。

alpha浮点数，默认值：1

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

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

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

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

范数str 或Normalize, 可选

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

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

一个实例Normalize或其子类之一（请参阅Colormap Normalization）。
刻度名称，即“linear”、“log”、“symlog”、“logit”等之一。有关可用刻度的列表，请调用matplotlib.scale.get_scale_names()。Normalize在这种情况下，会动态生成并实例化一个合适的子类。

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

vmin, vmax浮点数，可选

当使用标量数据且没有明确的norm时，vmin和vmax定义颜色图覆盖的数据范围。默认情况下，颜色图覆盖所提供数据的完整值范围。给定范数实例时使用vmin / vmax是错误的（但可以接受将范数名称与vmin / vmax一起使用）。str

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

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

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

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

无：在左下角的 X=0，Y=0 处。Z[0, 0]
'lower'：位于左下角的 X=0.5，Y=0.5 处。Z[0, 0]
'upper'：在左上角的X=N+0.5，Y=0.5处。Z[0, 0]
'image'：使用来自rcParams["image.origin"]（默认值：）的值'upper'。

范围（x0，x1，y0，y1），可选

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

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

locator ticker.Locator 子类，可选

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

扩展{'neither', 'both', 'min', 'max'}，默认值：'neither'

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

如果“两者都不是”，则级别范围之外的值不着色。如果是“min”、“max”或“both”，则为低于、高于或低于和高于水平范围的值着色。

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