complex_steerable_decompose — MOTIONMAG decompose op

数据种类:image2dtable

调用:import motionmag; motionmag.complex_steerable_decompose(image, scales: 'int' = 4, orientations: 'int' = 4) -> 'dict'(或 opsmotionmag.get("complex_steerable_decompose"))

用法

单帧的复数方向选择子带分解 -> `dict`。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

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 :func: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 :func:_filter_bank).

References: Freeman & Adelson, IEEE PAMI 1991; Simoncelli & Freeman,

ICIP 1995; Portilla & Simoncelli, IJCV 2000.

详细使用指南

motion_magnification 族使用指南

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者・年份)与用途见上面的族使用指南

可运行的示例(实际调用该算子并已验证的样例)

motion_magnificationpy -3.11 examples/motion_magnification.py

类型可衔接的下一个算子(可接受 table 作为输入)

complex_steerable_reconstruct

同类别(decompose)

complex_steerable_reconstruct


*Provenance: motionmag.py — MOTIONMAG 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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