displacement_series — MOTIONMAG `measure` op

• Datenarten: video → pairs

• Aufruf: import motionmag; motionmag.displacement_series(video, f_lo, f_hi, fps, scales: 'int' = 4, orientations: 'int' = 4) -> 'np.ndarray' (oder opsmotionmag.get("displacement_series"))

Verwendung

Verschiebungsverlauf des ganzen Bildes -> `(T, 2)-Array aus (dx, dy)`.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

The contrast-weighted spatial mean of :func:phase_displacement, i.e. the

rigid-body motion of the scene in pixels, one row per frame. This is the

trace to plot, or to feed to `dsp.spectrum` to read off the resonant

frequency — a vibration waveform recovered from a camera.

Weights are the same `|z|^2` contrast the field solve uses, restricted to

the pixels marked `valid`, so blank regions do not drag the average

towards zero. A clip with no valid pixel anywhere (a constant image) returns

exact zeros rather than a division by zero.

Sub-pixel accuracy and its cliff inherit from :func:phase_displacement;

measured on the 64x64x64 / 8 px / 4 Hz synthetic, a true 0.5 px amplitude is

recovered as 0.50000000 px (6.7e-16 relative), and a true 0.001 px amplitude

as 0.00100000 px (8.7e-15).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie motion_magnification

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)

• motion_magnification — py -3.11 examples/motion_magnification.py

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

Typkompatible Folge-Operatoren (nehmen `pairs` als Eingabe)

—

Gleiche Kategorie (`measure`)

phase_displacement

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

displacement_series — MOTIONMAG measure op