rotational_symmetry — AOI symmetry op

• 数据种类:image2d → table

• 调用: import fullseye as fs; fs.ledger.rotational_symmetry(image, max_order=12, angular_samples=720, score_threshold=0.18)(要直接调用实现,import symmetry2d; symmetry2d.rotational_symmetry(image, max_order=12, angular_samples=720, score_threshold=0.18);从台账取用则 opsaoi.get("rotational_symmetry"))

• GPU:无(仅 CPU 参考实现)

用法

返回180度点对称中心及由极坐标自相关得到的旋转对称阶数。

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

Parameters

image : array-like, shape (H, W)

グレー画像または region。

max_order : int, default 12

調べる最大次数。範囲は [2, 36]。

angular_samples : int, default 720

極座標の角度標本数。範囲は [180, 2880] で、2..max_order の公倍数を推奨。

score_threshold : float, default 0.18

正規化 RMS 差を対称とみなす上限。範囲は (0, 1)。

Returns

dict

center=(row,col)、point_symmetric、order、各次数の polar

autocorrelation と差を持つ table。order=1 は非回転対称を表す。

Notes

中心は外側エッジ対から推定し、その中心で極座標画像を作る。角度方向に 360/n 度循環シフトした自己相関を測り、しきい値を満たす最大 n を次数とする。定数入力、中心が求まらない入力は ValueError。同心円のように連続回転対称な像、角度標本数で割り切れない次数、中心から画像端まで対象が切れる像では次数は多義または不安定になる。

Loy and Zelinsky, Fast radial symmetry for detecting points of interest, IEEE TPAMI 25(8), 2003; Liu et al., FnT CGV 5(1-2), 2010.

详细使用指南

• aoi_frontend 族使用指南

参考(示例数据、文献)

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

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

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

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

• poc_symmetry_self_reference_inspection — py -3.11 examples/poc_symmetry_self_reference_inspection.py

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

symmetry_difference_map · symmetry_score

同类别(symmetry)

center_from_symmetric_edges · reflection_axis · symmetry_difference_map · symmetry_score


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

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