Python matplotlib Axes.tricontour用法及代碼示例

本文簡要介紹 python 語言中 matplotlib.axes.Axes.tricontour 的用法。

用法

Axes.tricontour(*args, **kwargs)

在非結構化三角形網格上繪製等高線。

調用簽名：

tricontour(triangulation, z, [levels], ...)
tricontour(x, y, z, [levels], *, [triangles=triangles], [mask=mask], ...)

可以通過傳遞 Triangulation 對象作為第一個參數來指定三角形網格，也可以通過傳遞點 x 、 y 以及可選的 triangles 和 mask 來指定。有關這些參數的說明，請參閱 Triangulation 。如果 triangulation 或 triangles 均未給出，則動態計算三角測量。

可以按位置傳遞 triangles ，即 tricontour(x, y, triangles, z, ...) 。然而，這是不鼓勵的。為了更清楚起見，請通過關鍵字參數傳遞triangles。

參數：

triangulation Triangulation ，可選

已經創建的三角形網格。

x, y, triangles, mask

定義三角網格的參數。請參閱 Triangulation 。這與指定 triangulation 是互斥的。

z 類數組

繪製輪廓的高度值。 Color-mapping 由 cmap 、 norm 、 vmin 和 vmax 控製。

注意

z 中的所有值都必須是有限的。因此，必須刪除 nan 和 inf 值或使用 set_mask 。

levels int 或類似數組，可選

確定等高線/區域的數量和位置。

如果 int n ，請使用 MaxNLocator ，它會嘗試在 Z 的最小和最大數值之間自動選擇不超過 n+1 "nice" 等高線級別。

如果是類似數組，則在指定級別繪製等高線。這些值必須按升序排列。

返回：

TriContourSet

其他參數：

colors 顏色字符串或顏色序列，可選

級別的顏色，即等高線。

該序列按升序循環級別。如果序列短於級別數，則重複。

作為一種快捷方式，可以使用單一顏色字符串代替單元素列表，即 'red' 而不是 ['red'] 以使用相同顏色為所有級別著色。此快捷方式僅適用於顏色字符串，不適用於其他指定顏色的方式。

默認情況下(值 None )，將使用由 cmap 指定的顏色圖。

alpha 浮點數，默認值：1

Alpha 混合值，介於 0(透明)和 1(不透明)之間。

cmap str 或 Colormap ，默認值：rcParams["image.cmap"](默認值：'viridis')

用於將標量數據映射到顏色的顏色圖實例或注冊的顏色圖名稱。

如果設置了colors，則忽略此參數。

norm str 或 Normalize ，可選

在使用 cmap 映射到顏色之前，用於將標量數據縮放到 [0, 1] 範圍的歸一化方法。默認情況下，使用線性縮放，將最低值映射到 0，將最高值映射到 1。

如果給出，這可以是以下之一：

• Normalize 或其子類之一的實例(請參閱顏色圖歸一化)。

• 比例名稱，即 "linear"、"log"、"symlog"、"logit" 等之一。有關可用比例的列表，請調用 matplotlib.scale.get_scale_names() 。在這種情況下，會動態生成並實例化合適的 Normalize 子類。

如果設置了colors，則忽略此參數。

vmin, vmax 浮點數，可選

當使用標量數據並且沒有顯式 norm 時，vmin 和 vmax 定義顏色圖覆蓋的數據範圍。默認情況下，顏色圖覆蓋所提供數據的完整值範圍。當給出 norm 實例時，使用 vmin /vmax 是錯誤的(但使用 str norm 名稱和 vmin /vmax 是可以接受的)。

如果未給出 vmin 或 vmax ，則默認顏色縮放基於 levels 。

如果設置了colors，則忽略此參數。

origin { None , 'upper', 'lower', 'image'}，默認值：無

通過指定 z[0, 0] 的位置來確定 z 的方向和準確位置。這僅在沒有給出 X 、 Y 的情況下才有意義。

• None ：z[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]的位置是像素的中心，而不是角點。如果 origin 為 None ，則 ( x0 , y0 ) 為 z[0, 0] 的位置，( x1 , y1 ) 為 z[-1, - 的位置1]。

如果在對輪廓的調用中指定了 X 和 Y，則忽略此參數。

locator ticker.Locator 子類，可選

如果未通過 levels 明確給出，則定位器用於確定輪廓級別。默認為 MaxNLocator 。

extend {'neither', 'both', 'min', 'max'}，默認：'neither'

確定 levels 範圍之外的值的 tricontour 著色。

如果是'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)。

linewidths 浮點數或類似數組，默認值：rcParams["contour.linewidth"](默認值：None)

等高線的線寬。

如果是數字，則所有級別都將使用此線寬繪製。

如果是一個序列，將按照指定的順序繪製升序級別的線寬。

如果沒有，這將回退到 rcParams["lines.linewidth"](默認值：1.5)。

linestyles { None , 'solid', 'dashed', 'dashdot', 'dotted'}，可選

如果 linestyles 是 None ，則默認值為 'solid' ，除非線條是單色的。在這種情況下，負輪廓將從 rcParams["contour.negative_linestyle"](默認值：'dashed')設置中獲取它們的線型。

linestyles 也可以是上述字符串的可迭代對象，指定要使用的一組線型。如果這個迭代比輪廓級別的數量短，它將根據需要重複。