matplotlib.axes.Axes.tripcolor#

Axes.tripcolor(*args, alpha=1.0, norm=None, cmap=None, vmin=None, vmax=None, shading='flat', facecolors=None, **kwargs)[source]#

创建一个非结构化三角网格的伪彩色图。

调用签名

tripcolor(triangulation, c, *, ...)
tripcolor(x, y, c, *, [triangles=triangles], [mask=mask], ...)

三角网格可以通过传递一个 Triangulation 对象作为第一个参数来指定，也可以通过传递点 x、y 以及可选的 triangles 和 mask 来指定。有关这些参数的说明，请参见 Triangulation。

可以将 triangles 按位置参数传递，即 tripcolor(x, y, triangles, c, ...)。但是，不建议这样做。为了更清晰，请通过关键字参数传递 triangles。

如果未提供 triangulation 或 triangles，则会即时计算三角剖分。在这种情况下，通过 c 或 facecolors 在三角形表面提供颜色是没有意义的，因为对于一组点有多种可能的三角剖分，且无法预知将构建哪些三角形。

参数:

triangulationTriangulation

已创建的三角网格。

x, y, triangles, mask

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

c类数组结构 (array-like)

颜色值，可以是点或三角形的颜色。系统会自动根据 c 的长度推断使用哪种颜色，即它匹配的是点的数量还是三角形的数量。如果三角剖分中的点数和三角形数量相同，则假定颜色值定义在点上；要强制使用三角形上的颜色值，请使用关键字参数 facecolors=c 代替 c。此参数仅限位置参数。

facecolors类数组结构，可选

可作为 c 的替代方案，用于指定三角形表面的颜色。此参数的优先级高于 c。

shading{'flat', 'gouraud'}, default: 'flat'

如果 shading 为 'flat' 且颜色值 c 定义在点上，则每个三角形使用的颜色值为该三角形三个顶点的 c 平均值。如果 shading 为 'gouraud'，则颜色值必须定义在点上。

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

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

norm字符串或 Normalize，可选

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

如果给定，可以是以下之一

Normalize 实例或其子类之一（请参阅颜色映射归一化）。
刻度名称，例如 "linear"、"log"、"symlog"、"logit" 等。若要获取可用刻度列表，请调用 matplotlib.scale.get_scale_names()。在这种情况下，将动态生成并实例化合适的 Normalize 子类。

vmin, vmax浮点型，可选

当使用标量数据且没有显式指定 norm 时，vmin 和 vmax 定义了颜色映射所涵盖的数据范围。默认情况下，颜色映射涵盖所提供数据的完整值范围。当给定 norm 实例时，使用 vmin/vmax 是错误的（但将 str 类型的 norm 名称与 vmin/vmax 一起使用是可以的）。

colorizerColorizer 或 None，默认：None

用于将颜色映射到数据的 Colorizer 对象。如果为 None，则从 norm 和 cmap 创建一个 Colorizer 对象。

返回:

PolyCollection 或 TriMesh: 结果取决于 shading：对于 shading='flat'，结果为 PolyCollection；对于 shading='gouraud'，结果为 TriMesh。

其他参数:

**kwargsCollection 属性

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	类数组或浮点数或 None
`animated`	布尔值
`antialiased` 或 `aa` 或 `antialiaseds`	布尔值或布尔值列表
`array`	类数组或 None
`capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`clim`	(vmin: 浮点数, vmax: 浮点数)
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔值
`clip_path`	Patch 或 (Path, Transform) 或 None
`cmap`	`Colormap` 或字符串或 None
`color`	颜色或 RGBA 元组列表
`edgecolor` 或 `ec` 或 `edgecolors`	color 或 color 列表或 'face'
`facecolor` 或 `facecolors` 或 `fc`	color 或 color 列表
`figure`	`Figure` 或 `SubFigure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	未知
`hatchcolor`	color 或 color 列表或 'edge'
`in_layout`	布尔值
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`label`	object
`linestyle` 或 `dashes` 或 `linestyles` 或 `ls`	{'-', '--', '-.', ':', '', ...} 或 (offset, on-off-seq) 或其列表
`linewidth` 或 `linewidths` 或 `lw`	浮点数或浮点数列表
`mouseover`	布尔值
`norm`	`Normalize` 或字符串或 None
`offset_transform` 或 `transOffset`	`变换`
`offsets`	(N, 2) 或 (2,) 类数组
`path_effects`	`AbstractPathEffect` 列表
`paths`	未知
`picker`	None 或布尔值或浮点数或可调用对象
`pickradius`	浮点数
`rasterized`	布尔值
`sketch_params`	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
`snap`	布尔值或 None
`transform`	`变换`
`url`	str
`字符串列表或 None`	urls
`visible`	布尔值
`zorder`	浮点数

使用 `matplotlib.axes.Axes.tripcolor` 的示例#

三角颜色图演示

tripcolor(x, y, z)

matplotlib.axes.Axes.tripcolor#

使用 matplotlib.axes.Axes.tripcolor 的示例#

使用 `matplotlib.axes.Axes.tripcolor` 的示例#