complex_steerable_decompose — MOTIONMAG decompose op

• Data kinds: image2d → table

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

उपयोग

एक frame का complex oriented sub-band decomposition -> dict।

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

Splits the image into scales * orientations analytic sub-bands plus three residuals (low-pass, high-pass and a small symmetric completion band). Each sub-band is a full-resolution (H, W) complex array whose modulus is the local contrast of that scale/orientation and whose argument is the local phase — the quantity a translation shifts linearly, which is what the rest of this module is built on. There is no spatial decimation: keeping every band at full resolution costs memory but makes the frame exactly invertible, and exactness is the point.

Returns {"bands": [complex (H, W), ...], "kinds": [...], "centre_cycles_per_px": [...], "orientation_rad": [...], "shape": (H, W), "scales": s, "orientations": k}. kinds[j] is "band" for an oriented sub-band and "lowpass" / "highpass" / "residual" otherwise; centre_cycles_per_px and orientation_rad are None for residuals, which have no orientation and no single centre frequency.

Feed the whole dict back to complex_steerable_reconstruct. Round trip error, measured on a 64x64 random frame with the defaults, is max|out - in| = 6.66e-16; on a 31x37 (odd, non-square) frame 7.22e-16; and the worst over every scales in 1..8 crossed with every orientations in 1..16 on 32x32 is 7.77e-16 — the tight-frame construction is exact, not approximate (see the notes on the self-conjugate grid points

in _filter_bank).

References: Freeman & Adelson, IEEE PAMI 1991; Simoncelli & Freeman, ICIP 1995; Portilla & Simoncelli, IJCV 2000.

उपयोग की विस्तृत 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

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

complex_steerable_reconstruct

इसी category के (decompose)

complex_steerable_reconstruct


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