riesz_displacement_series — QUAT motion op

Datenarten: videopairs

Aufruf: import quatimage; quatimage.riesz_displacement_series(video, f_lo, f_hi, fps, scales: 'int' = 4) -> 'np.ndarray' (oder opsquat.get("riesz_displacement_series"))

Verwendung

Verschiebungsverlauf des ganzen Bildes aus der monogenen Phase. → (T, 2).

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

The contrast-weighted spatial mean of :func:riesz_displacement: the

rigid-body motion of the scene in pixels, one `(dx, dy)` row per frame.

The `(n, 2) layout is the shared 1-D convention (dsp.spectrum`,

`funct1d, opsoptics`'s MTF curves), so the trace can be handed to

`dsp.spectrum` to read off a resonant frequency without any repacking.

Weights are the `|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 dividing by zero.

Accuracy, the `J0` cliff and the multi-orientation failure all inherit from

:func:riesz_displacement — read its head-to-head table before trusting a

number from here. On a single-grating 64x64x64 / 8 px / 4 Hz clip a true

0.5 px amplitude is recovered as 0.50000000000000 px (2.2e-16 relative);

on the two-grating `motionmag.synthesize_translation` default the same

0.5 px comes back 13.0 % low, with nothing to signal it.

Ausführlicher Anwendungsleitfaden

Leitfaden zur Familie quaternion_monogenic

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)

quaternion_monogenicpy -3.11 examples/quaternion_monogenic.py

Typkompatible Folge-Operatoren (nehmen pairs als Eingabe)

Gleiche Kategorie (motion)

riesz_motion_magnify · riesz_displacement


*Provenance: quatimage.py — QUAT 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.