vol_flow_3d — LIVE4D flow op

• Datenarten: voxel × voxel → flow_dense

• Aufruf: 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' (die Implementierung direkt: 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'; aus dem Register: opslive4d.get("vol_flow_3d"))

Verwendung

Dichtes Verschiebungsfeld (3, Z, Y, X) zwischen zwei Volumen (flow_dense, Komponenten dz, dy, dx [voxel]).

vol_b(x) ≈ vol_a(x − d), d. h. die Struktur von vol_a bewegt sich um +d und wird zu vol_b (dieselbe Konvention wie die torch-Version scene_flow_lk). Eine 3-D-Version von Lucas–Kanade nur mit numpy + scipy: win ist die halbe Fensterbreite (Seitenlänge des Fensters 2·win + 1), pyr_levels die Anzahl der Pyramidenstufen (bei großen Verschiebungen erhöhen; jede Stufe 1/2), iters die Warp-Iterationen pro Stufe, reg die Regularisierung der Strukturtensor-Diagonale (vermeidet Division durch 0 in ebenen Bereichen; je größer, desto mehr geht der Fluss dort gegen 0). In ebenen Bereichen ohne Textur ist der Fluss unbestimmt (Aperturproblem) -- vertrauen Sie ihm nur, wo es einen Gradienten gibt.

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

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie live4d

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_live4d — py -3.11 examples/poc_live4d.py

Typkompatible Folge-Operatoren (nehmen flow_dense als Eingabe)

—

Gleiche Kategorie (flow)

volseq_speed · volseq_pathline_render · volseq_pathline_orbit


*Provenance: live4d.py — LIVE4D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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