riesz_displacement_series — QUAT motion op

• Data kinds: video → pairs

• Call: import fullseye as fs; fs.ledger.riesz_displacement_series(video, f_lo, f_hi, fps, scales: 'int' = 4) -> 'np.ndarray' (implementation को सीधे call करना हो तो import quatimage; quatimage.riesz_displacement_series(video, f_lo, f_hi, fps, scales: 'int' = 4) -> 'np.ndarray', registry से लेना हो तो opsquat.get("riesz_displacement_series"))

उपयोग

monogenic phase से पूरे frame का displacement waveform। → (T, 2)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

The contrast-weighted spatial mean of 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 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.

उपयोग की विस्तृत guide

• quaternion_monogenic family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

वे अगले ops जिनसे type जुड़ता है (pairs को input के रूप में लेते हैं)

—

इसी category के (motion)

riesz_motion_magnify · riesz_displacement


*Provenance: quatimage.py — QUAT operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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