piv_quiver — PIV `visualise` op

• 資料種類:flow2d → rgb

• 呼叫: import fullseye as fs; fs.ledger.piv_quiver(flow, spacing=None, scale=None, upsample=8, background=None, color=(0.08, 0.08, 0.12), width=1.5)(要直接呼叫實作,import pivops; pivops.piv_quiver(flow, spacing=None, scale=None, upsample=8, background=None, color=(0.08, 0.08, 0.12), width=1.5);從台帳取用則 opspiv.get("piv_quiver"))

用法

箭頭圖(MATLAB 的 quiver)。回傳 (h*upsample, w*upsample, 3)。

每 spacing 個網格畫 1 根，起點放在網格點上，箭頭尖畫到 起點 + scale * v 處。省略 scale 時最長的箭頭為間隔的 0.9 倍(與 MATLAB 的自動倍率相同的想法，不與相鄰箭頭重疊)。倍率每張圖都會變，因此並排比較的圖請固定 scale。長度不足 1 像素的箭頭不畫(沒有方向的點會被讀作標記)。

Args:

flow: (2, h, w)(dy, dx)。

spacing: 箭頭的間隔 [網格]。None 時長邊約 20 根。

scale: 箭頭長度 = scale * 速度 [網格]。

upsample: 輸出的倍數(放大到足以畫出箭頭尖)。

background: (h*upsample, w*upsample) 或 (…, 3)。None 為白色。

可以鋪色相圖(把 piv_flow_to_rgbimage 放大後的圖)或 LIC。

color / width: 箭頭顏色(palette 的角色名或 RGB)與箭桿粗細 [px]。

預設為接近黑色的墨色(鋪了色相圖也能讀)。

Returns:

(h*upsample, w*upsample, 3) float64，值域 [0, 1]。

詳細使用指南

• piv_displacement 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py

型別可銜接的下一個運算子(可接受 `rgb` 作為輸入)

—

同類別(`visualise`)

piv_flow_to_rgbimage · piv_line_integral_convolution · piv_streamlines · piv_streamline_image

*Provenance: pivops.py — PIV 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

piv_quiver — PIV visualise op

用法