matplotlib.pyplot.tricontour #
- matplotlib.pyplot。tricontour ( * args , ** kwargs ) [来源] #
在非结构化三角形网格上绘制等高线。
来电签名:
tricontour(triangulation, Z, [levels], ...) tricontour(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)
Triangulation
可以通过将对象作为第一个参数传递,或者通过传递点x、y以及可选的三角形和掩码来指定三角形网格。有关这些参数的说明,请参阅Triangulation
。如果三角剖分或 三角形都没有给出,三角剖分是即时计算的。可以按位置传递三角形,即 . 但是,这是不鼓励的。为了更清楚,通过关键字参数传递三角形。
tricontour(x, y, triangles, Z, ...)
- 参数:
- 三角测量
Triangulation
,可选 已经创建的三角形网格。
- x, y, 三角形, 蒙版
定义三角网格的参数。见
Triangulation
。这与指定triangulation是互斥的。- Z阵列状
绘制轮廓的高度值。颜色映射由cmap、norm、vmin和vmax控制。
- 级别int 或类似数组,可选
确定等高线/区域的数量和位置。
如果是 int n,请使用,它会尝试在vmin和vmax
MaxNLocator
之间自动选择不超过n+1 个“nice”等高线级别 。如果类似数组,则在指定级别绘制等高线。这些值必须按升序排列。
- 三角测量
- 返回:
- 其他参数:
- 颜色颜色字符串或颜色序列,可选
级别的颜色,即等高线。
该序列按升序循环用于各个级别。如果序列短于层数,则重复。
作为一种捷径,可以使用单一颜色字符串来代替单元素列表,即
'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'
确定级别范围
tricontour
之外的值 的着色。如果“两者都不是”,则级别范围之外的值不着色。如果是“min”、“max”或“both”,则为低于、高于或低于和高于 水平范围的值着色。
低于
min(levels)
和高于max(levels)
的值映射到 的低于/高于 的值Colormap
。请注意,默认情况下,大多数颜色图没有专门的颜色,因此上值和下值是颜色图的边缘值。您可能希望使用Colormap.set_under
和显式设置这些值Colormap.set_over
。笔记
TriContourSet
如果更改其颜色图的属性,则不会通知现有的。ContourSet.changed()
因此,修改颜色图后需要显式调用 。如果将颜色条分配给 ,则可以省略显式调用,TriContourSet
因为它在内部调用ContourSet.changed()
.- xunits, yunits注册单位,可选
通过指定 a 的实例来覆盖轴单位
matplotlib.units.ConversionInterface
。- 抗锯齿布尔,可选
启用抗锯齿,覆盖默认值。对于填充轮廓,默认值为True。对于线轮廓,它取自
rcParams["lines.antialiased"]
(默认值:)True
。- 线宽浮动或类似数组,默认:(
rcParams["contour.linewidth"]
默认None
:) 等高线的线宽。
如果是数字,则所有级别都将使用此线宽绘制。
如果是一个序列,将按照指定的顺序绘制升序级别的线宽。
如果没有,这将回退到
rcParams["lines.linewidth"]
(默认值:)1.5
。- 线条样式{无, 'solid', 'dashed', ' dashdot ', 'dotted'}, 可选
如果linestyles为None,则默认值为 'solid',除非线条是单色的。在这种情况下,负轮廓将从
rcParams["contour.negative_linestyle"]
(默认:)'dashed'
设置中获取它们的线型。linestyles也可以是上述字符串的可迭代,指定要使用的一组线型。如果这个迭代比轮廓级别的数量短,它将根据需要重复。