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。

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

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

参数:

triangulationTriangulation

已创建的三角网格。

x, y, triangles, mask

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

carray-like

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

facecolorsarray-like, optional

可以替代 c 用于指定三角形面的颜色。此参数优先于 c。

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

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

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

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

normstr 或 Normalize, optional

在采用 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, default: 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`	颜色或颜色列表或 'face'
`facecolor` 或 `facecolors` 或 `fc`	颜色或颜色列表
`figure`	`Figure` 或 `SubFigure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	未知
`in_layout`	布尔值
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`label`	object
`linestyle` 或 `dashes` 或 `linestyles` 或 `ls`	字符串或元组或其列表
`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` 的示例#