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"))

用法

> 该算子的说明尚无译文,以下照原文给出。

2 つの体積の間の密な変位場 `(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 と同じ約束)。Lucas–Kanade の 3 次元版を numpy + scipy だけで: 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 自动生成(请勿手工编辑)。*

vol_flow_3d — LIVE4D flow op

用法