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

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

用法

Axes.barbs(*args, data=None, **kwargs)

繪製一個 2D 倒鉤場。

調用簽名：

barbs([X, Y], U, V, [C], **kwargs)

其中 X 、 Y 定義倒鉤位置， U 、 V 定義倒鉤方向， C 可選擇設置顏色。

所有參數可能是一維或二維的。 U , V , C 可能是被屏蔽的數組，但目前不支持被屏蔽的 X , Y。

倒鉤傳統上在氣象學中用作繪製風觀測速度和方向的一種方式，但在技術上可用於繪製任何二維向量。與通過箭頭長度給出矢量幅度的箭頭相反，倒鉤通過將斜線或三角形放置在幅度上的各種增量來提供有關矢量幅度的更多定量信息，如下圖所示：

:                   /\    \
:                  /  \    \
:                 /    \    \    \
:                /      \    \    \
:               ------------------------------

最大增量由三角形(或"flag")給出。之後是完整的線條(倒鉤)。最小的增量是半線。當然，最多隻有 1 條半線。如果幅度很小並且隻需要一個half-line 並且沒有完整的線或三角形，則half-line 會從倒鉤的末端偏移，以便可以輕鬆地將其與具有單個完整線的倒鉤區分開來。使用標準增量 50、10 和 5，上述倒鉤的大小名義上為 65。

另見https://en.wikipedia.org/wiki/Wind_barb。

參數：

X, Y 一維或二維數組，可選

倒鉤位置的 x 和 y 坐標。有關如何將倒鉤繪製到 x、y 位置的信息，請參見pivot。

如果沒有給出，它們將根據 U 和 V 的尺寸生成為統一的整數網格網格。

如果 X 和 Y 是一維的，但 U 、 V 是二維的，則 X 、 Y 使用 X, Y = np.meshgrid(X, Y) 擴展為二維。在這種情況下，len(X) 和 len(Y) 必須與 U 和 V 的列和行維度匹配。

U, V 一維或二維數組

倒鉤軸的 x 和 y 分量。

C 一維或二維數組，可選

通過 norm 和 cmap 進行顏色映射定義倒鉤顏色的數值數據。

這不支持顯式顏色。如果要直接設置顏色，請改用barbcolor。

length 浮點數，默認值：7

倒鉤的長度(以點為單位)；倒鉤的其他部分與此相對。

pivot {'tip', 'middle'} 或浮點數，默認：'tip'

錨定到 X 、 Y 網格的箭頭部分。倒鉤圍繞這一點旋轉。這也可以是一個數字，它將倒鉤的起點從網格點移開很多點。

barbcolor 顏色或顏色順序

除旗幟外，倒鉤所有部分的顏色。此參數類似於多邊形的edgecolor 參數，可以改為使用該參數。但是，此參數將覆蓋 facecolor。

flagcolor 顏色或顏色順序

倒鉤上任何標誌的顏色。此參數類似於多邊形的facecolor 參數，可以改為使用該參數。但是，此參數將覆蓋 facecolor。如果未設置(並且 C 也未設置)，則 flagcolor 將設置為與 barbcolor 匹配，以便倒鉤具有統一的顏色。如果已設置C，則flagcolor 無效。

sizes 字典，可選

係數字典，指定給定特征與倒鉤長度的比率。隻有那些希望覆蓋的值需要被包括在內。這些函數包括：

• 'spacing' - 特征之間的空間(標誌，全/半倒鉤)

• 'height' - 旗幟或倒鉤的高度(從軸到頂部的距離)

• 'width' - 旗幟的寬度，是倒鉤寬度的兩倍

• 'emptybarb' - 用於低震級的圓的半徑

fill_empty 布爾值，默認值：假

繪製的空倒鉤(圓圈)是否應該用標誌顏色填充。如果它們未填充，則中心是透明的。

rounding 布爾值，默認值：真

分配倒鉤分量時是否對向量幅度進行四舍五入。如果為 True，則將幅度四舍五入到最接近的 half-barb 增量的倍數。如果為 False，則幅度被簡單地截斷為下一個最低倍數。

barb_increments 字典，可選

一個增量字典，指定與倒鉤的不同部分相關聯的值。隻有那些希望覆蓋的值需要被包括在內。

• 'half' - 半個倒鉤(默認為 5)

• 'full' - 完整的倒鉤(默認為 10)

• 'flag' - 標誌(默認為 50)

flip_barb bool 或類似 bool 的數組，默認值：False

線條和標誌是否應指向與法線相反的方向。正常行為是倒鉤和線指向右側(來自具有這些特征的風倒鉤指向北半球的低壓)。

單個值應用於所有倒鉤。可以通過傳遞與 U 和 V 大小相同的 bool 數組來翻轉單個倒鉤。

返回：

barbs matplotlib.quiver.Barbs

其他參數：

data 可索引對象，可選

如果給定，所有參數也接受一個字符串 s ，它被解釋為 data[s] (除非這引發異常)。

**kwargs

可以使用 PolyCollection 關鍵字參數進一步自定義倒鉤：

屬性	說明
agg_filter	一個過濾器函數，它接受一個 (m, n, 3) 浮點數組和一個 dpi 值，並返回一個 (m, n, 3) 數組和距圖像左下角的兩個偏移量
alpha	類似數組或標量或無
animated	bool
antialiased 或 aa 或抗鋸齒	布爾或布爾列表
array	類似數組或無
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin：浮點數，vmax：浮點數)
clip_box	BboxBase 或無
clip_on	bool
clip_path	補丁或(路徑，變換)或無
cmap	Colormap 或 str 或 None
color	顏色或 RGBA 元組列表
edgecolor 或 ec 或 edgecolors	顏色或顏色列表或'face'
facecolor 或 facecolors 或 fc	顏色或顏色列表
figure	Figure
gid	str
matplotlib.collections.Collection.set_hatch	{'/'、'\'、'|'、'-'、'+'、'x', 'o'、'O'、'.'、'*'}
in_layout	bool
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或破折號或線條樣式或 ls	str 或元組或其列表
linewidth 或線寬或 lw	浮點數或浮點數列表
mouseover	bool
norm	Normalize 或 str 或 None
offset_transform 或 transOffset	Transform
offsets	(N, 2) 或 (2,) 類似數組
path_effects	AbstractPathEffect 列表
paths	類似數組的列表
picker	None 或 bool 或 float 或可調用
pickradius	float
rasterized	bool
sizes	numpy.ndarray 或無
sketch_params	(比例：浮點數，長度：浮點數，隨機性：浮點數)
snap	布爾或無
transform	Transform
url	str
urls	str 或 None 的列表
verts	類似數組的列表
verts_and_codes	unknown
visible	bool
zorder	float