symmetry_score — AOI symmetry op

• Data kinds: image2d × table → measurement

• Call: import fullseye as fs; fs.ledger.symmetry_score(image, symmetry, exclusion_mask=None, detrend=True) (to call the implementation directly, import symmetry2d; symmetry2d.symmetry_score(image, symmetry, exclusion_mask=None, detrend=True); from the registry, opsaoi.get("symmetry_score"))

• GPU: none (CPU reference implementation only)

Usage

Returns distance from symmetry by normalising the self-referenced difference by image dynamic range.

> The detailed description below is the original text — the summary and the headings are translated.

Parameters

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

検査するグレー画像。

symmetry : dict

反射軸または回転中心の table。

exclusion_mask : array-like or None, default None

設計上の非対称を除外する mask。形は image と同じ。

detrend : bool, default True

線形照明差を除くなら True。

Returns

float

有効画素の平均絶対差 / 画像ダイナミックレンジ。0 が完全対称で、大きいほど

対称から遠い連続値。

Notes

定数・一様入力は相対床で ValueError。この値は同じ画像、同じモデル、同じ mask の乱れを比較する量で、異なる補間床や画角の画像を一律の合否しきい値で比べない。軸・中心を乱れた画像自身から毎回再推定すると、推定器が欠陥へ寄って単調性を弱める。

Detailed usage guide

• aoi_frontend family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• poc_symmetry_self_reference_inspection — py -3.11 examples/poc_symmetry_self_reference_inspection.py

Ops the type connects to (they accept measurement as input)

—

Same category (symmetry)

center_from_symmetric_edges · reflection_axis · rotational_symmetry · symmetry_difference_map


*Provenance: symmetry2d.py — AOI operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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