temporal_bandpass — MOTIONMAG temporal op

• Data kinds: video → video

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

उपयोग

हर pixel की time series का ideal temporal band-pass -> (T, H, W)।

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

Each pixel is transformed along time, every DFT bin whose frequency lies outside [f_lo, f_hi] (in Hz, magnitude, DC always excluded) is zeroed, and the result is transformed back. Frequency-selective where videops.moving_average and videops.spatiotemporal_gaussian are low-pass; this is the filter isolating "what is happening at 4 Hz".

Exact for a component sitting on a bin: with T frames at fps, a sinusoid at k*fps/T Hz passes with gain 1 and everything else in the band passes untouched. Measured on a bin-centred 4 Hz unit sinusoid in a 64-frame 32 fps clip that also carries a DC offset of 0.5 and a 12 Hz component of amplitude 0.3, the recovered waveform matches the 4 Hz term alone to max|err| = 4.36e-15.

A brick-wall filter rings in time; that is the price of an exact pass-band and it is the same choice the 2012 Eulerian magnification paper makes. The output is zero-mean along time by construction.

उपयोग की विस्तृत 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_beam_modal_video — py -3.11 examples/poc_beam_modal_video.py

• poc_motion_magnification — py -3.11 examples/poc_motion_magnification.py

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

temporal_band_power · band_snr · motion_magnify · phase_displacement · displacement_series

इसी category के (temporal)

temporal_band_power · band_snr


*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.