当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Python matplotlib.axes.Axes.tricontourf用法及代码示例


用法

Axes.tricontourf(*args, **kwargs)

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

可以通过以下两种方式之一指定三角剖分;任何一个

tricontourf(triangulation, ...)

其中 triangulation Triangulation 对象,或

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

在这种情况下,将创建 Triangulation 对象。有关这些情况的解释,请参见该类的文档字符串。

剩下的论点可能是:

tricontourf(..., Z)

其中Z 是轮廓值的数组,三角剖分中的每个点一个。级别值是自动选择的。

tricontourf(..., Z, levels)

轮廓达到levels+1 自动选择的轮廓级别(levels 间隔)。

tricontourf(..., Z, levels)

在序列 levels 中指定的值处绘制轮廓区域,这些值必须按升序排列。

tricontourf(Z, **kwargs)

使用关键字参数来控制颜色、线宽、原点、cmap ...有关详细信息,请参见下文。

参数

triangulation Triangulation ,可选

非结构化三角形网格。

如果指定,则不接受 xytrianglesmask

x, y array-like,可选

Z 中值的坐标。

triangles (ntri, 3) array-like of int,可选

对于每个三角形,组成三角形的三个点的索引以逆时针方式排列。如果未指定,则计算 Delaunay 三角剖分。

mask (ntri,) array-like of bool,可选

哪些三角形被掩盖了。

Z 2D array-like

绘制轮廓的高度值。

levels int 或 array-like,可选

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

如果是 int n ,请使用 MaxNLocator ,它会尝试在 vminvmax 之间自动选择不超过 n+1 "nice" 轮廓级别。

如果array-like,在指定的级别绘制等高线。这些值必须按升序排列。

返回

TriContourSet

其他参数

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

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

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

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

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

alpha 浮点数,默认值:1

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

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

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

如果同时给出colorscmap,则会引发错误。

norm Normalize ,可选

如果使用颜色图, Normalize 实例将级别值缩放到规范颜色图范围 [0, 1] 以映射到颜色。如果没有给出,则使用默认的线性缩放。

vmin, vmax 浮点数,可选

如果不是 None ,这些值中的一个或两个将提供给 Normalize 实例,覆盖基于 levels 的默认颜色缩放。

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

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

  • NoneZ[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] 的位置是像素的中心,而不是角落。如果 originNone ,那么 ( x0 , y0 ) 是 Z[0, 0] 的位置,并且 ( x1 , y1 ) 是 Z[-1, - 1]。

如果在对轮廓的调用中指定了 XY,则忽略此参数。

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 填充顶部闭合的区间;也就是说,对于边界 z1z2 ,填充区域为:

z1 < Z <= z2

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

相关用法


注:本文由纯净天空筛选整理自matplotlib.org大神的英文原创作品 matplotlib.axes.Axes.tricontourf。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。