matplotlib.pyplot.tricontour

matplotlib.pyplot.tricontour(*args, **kwargs)[源代码]

在非结构化三角网格上绘制等高线。

三角剖分可以用以下两种方法之一指定：

tricontour(triangulation, ...)

在哪里？ 三角测量 是一个 Triangulation 对象，或：

tricontour(x, y, ...)
tricontour(x, y, triangles, ...)
tricontour(x, y, triangles=triangles, ...)
tricontour(x, y, mask=mask, ...)
tricontour(x, y, triangles, mask=mask, ...)

在这种情况下a Triangulation 对象将被创建。有关这些情况的解释，请参见该类的docstring。

其余参数可以是：：

tricontour(..., Z)

在哪里？ Z 是要轮廓的值数组，在三角测量中每个点一个。级别值是自动选择的。

tricontour(..., Z, levels)

轮廓向上 等级+1 自动选择的轮廓级别（ 水平 间隔）

tricontour(..., Z, levels)

按顺序指定的值绘制轮廓线 水平 ，必须按递增顺序排列。

tricontour(Z, **kwargs)

使用关键字参数控制颜色、线宽、原点、cmap。。。详见下文。

参数:
三角测量 ： Triangulation 可选三角测量，可选

非结构化三角网格。

如果指定，则 x ， y ， 三角形 和 mask 不接受。

x, y类似数组，可选

值的坐标 Z .

triangles形状类似int数组（ntri，3），可选

对于每个三角形，构成三角形的三个点的指数，按逆时针顺序排列。如果未指定，则计算Delaunay三角测量。

maskbool-array-like-of-shape（ntri），可选

哪些三角形被遮住了。

Z类阵列（n，m）

绘制轮廓的高度值。

levelsint或array-like，可选

确定轮廓线/区域的数量和位置。

如果int n 使用 MaxNLocator ，尝试自动选择不超过 n+1 “不错”的轮廓水平之间 vmin 和 vmax .

如果像数组，则在指定级别绘制等高线。值必须按递增顺序排列。
返回:
TriContourSet
其他参数:
colors颜色字符串或颜色序列，可选

水平面的颜色，即等高线。

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

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

默认情况下（值 None ）指定的颜色映射 cmap 将被使用。

alpha浮点，默认值：1

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

cmap : str or Colormap, default: rcParams["image.cmap"] (default: 'viridis')str或

A Colormap 实例或注册的颜色映射名称。colormap将级别值映射到颜色。

如果两者 ** 和 cmap 如果给定，则引发错误。

norm ： Normalize 可选正常化，可选

如果使用颜色映射，则 Normalize 实例将级别值缩放到标准颜色映射范围 [0, 1] 用于映射到颜色。如果未给出，则使用默认的线性比例。

起源 { None ，'upper'，'lower'，'image'}，默认值：无{None, 'upper', 'lower', 'image'}, default: None

确定的方向和精确位置 Z 通过指定 Z[0, 0] . 这只是相关的，如果 X ， Y 没有给出。

  • None ： Z[0, 0] 在左下角的x=0，y=0处。
  • “下”： Z[0, 0] 在左下角的x=0.5，y=0.5处。
  • “鞋帮”： Z[0, 0] 在左上角的x=n+0.5，y=0.5处。
  • “image”：使用来自的值 rcParams["image.origin"] (default: 'upper') .
extent（X0，X1，Y0，Y1），可选

如果 起源 不是 None 然后 程度 被解释为 imshow ：提供外部像素边界。在这种情况下，z的位置 [0, 0] 是像素的中心，而不是一个角。如果 起源 是 None 然后（ x0 ， y0 ）是z的位置 [0, 0] ，以及（ x1 ， y1 ）是z的位置 [-1, -1] .

如果 X 和 Y 在轮廓调用中指定。

locatorticker.locator子类，可选

定位器用于确定轮廓水平，如果没有通过 水平 .默认为 MaxNLocator .

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

决定 tricontour -对外部值的着色 水平 范围。

如果“两者都不是”，则值在 水平 范围没有颜色。如果是“min”、“max”或“both”，则将以下值、以上值或以下值和以上值涂上颜色 水平 范围。

下面的值 min(levels) 及以上 max(levels) 映射到 Colormap . 请注意，默认情况下，大多数colormaps没有这些颜色的专用颜色，因此over和under值是colormap的边值。您可能需要使用显式设置这些值 Colormap.set_under 和 Colormap.set_over .

注解

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

X单位注册单位，可选

通过指定 matplotlib.units.ConversionInterface .

线宽度 : float or array-like, default: rcParams["contour.linewidth"] (default: None)浮点或类似数组，默认值：

轮廓线的线条宽度。

如果是数字，则所有级别都将使用此线条宽度打印。

如果是序列，则将按指定的顺序用线条宽度绘制升序级别。

如果没有，则返回到 rcParams["lines.linewidth"] (default: 1.5) .

直线运动 { None ，'solid'、'dashdot'、'dashdot'、'dotted'，可选{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional

如果 直线运动 是 None ，除非线条为单色，否则默认值为“纯色”。在这种情况下，负轮廓将从 rcParams["contour.negative_linestyle"] (default: 'dashed') 设置。

直线运动 也可以是上面指定要使用的一组线条样式的字符串的可重复项。如果此iterable比轮廓级别数短，则将根据需要重复此iterable。