displacement_series — MOTIONMAG measure op

• Data kinds: video → pairs

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

उपयोग

पूरे frame का displacement waveform -> (dx, dy) का (T, 2) array।

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

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

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

• motion_magnification 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 करते हैं)

• motion_magnification — py -3.11 examples/motion_magnification.py

• poc_motion_magnification — py -3.11 examples/poc_motion_magnification.py

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

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

—

इसी category के (measure)

phase_displacement


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

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