vol_flow_3d — LIVE4D flow op

• 資料種類:voxel × voxel → flow_dense

• 呼叫: import fullseye as fs; fs.ledger.vol_flow_3d(vol_a, vol_b, win: 'int' = 3, pyr_levels: 'int' = 3, iters: 'int' = 5, reg: 'float' = 0.001) -> 'np.ndarray'(要直接呼叫實作,import live4d; live4d.vol_flow_3d(vol_a, vol_b, win: 'int' = 3, pyr_levels: 'int' = 3, iters: 'int' = 5, reg: 'float' = 0.001) -> 'np.ndarray';從台帳取用則 opslive4d.get("vol_flow_3d"))

用法

兩個體積之間的稠密位移場 (3, Z, Y, X)(flow_dense,分量 dz, dy, dx [voxel])。

vol_b(x) ≈ vol_a(x − d),即 vol_a 的結構移動 +d 成為 vol_b(與 torch 版 scene_flow_lk 相同的約定)。只用 numpy + scipy 實作 Lucas–Kanade 的 3 維版本:win 是視窗的半寬(視窗邊長 2·win + 1),pyr_levels 是金字塔層數(位移越大越要增加,每層 1/2),iters 是每層的 warp 迭代次數,reg 是結構張量對角的正則化(避免平坦處除以 0。越大,平坦處的流越趨向 0)。在沒有紋理的平坦處,流無法確定(孔徑問題)—— 只在有梯度的地方才可信。

>>> a = volseq_synth_dividing((16, 24, 24), n_frames=4, split_frame=0, speed=1.0)

>>> d = vol_flow_3d(a[1], a[2]); d.shape

(3, 16, 24, 24)

詳細使用指南

• live4d 族使用指南

參考(範例資料、文獻)

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

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

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

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

• poc_live4d — py -3.11 examples/poc_live4d.py

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

—

同類別(flow)

volseq_speed · volseq_pathline_render · volseq_pathline_orbit


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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.