detect_rotational_symmetry — 3D `symmetry` op

• Data kinds: points → primitive

• Call: import fullseye as fs; fs.ledger.detect_rotational_symmetry(points, orders=(2, 3, 4, 6, 8)) (to call the implementation directly, import symmetry3d; symmetry3d.detect_rotational_symmetry(points, orders=(2, 3, 4, 6, 8)); from the registry, ops3d.get("detect_rotational_symmetry"))

Usage

Choose the best rotational symmetry (axis × order) with the PCA principal axes as candidate axes.

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

→ dict{axis_point, axis_dir, order, score, table, margin}。

score が小さいほど対称。

★ `margin`(2 位との差)を必ず併読すること。理由は

:func:detect_reflection_symmetry と同じ —— 候補が団子なら選択はくじ引きで、

そのとき先に潰れるのは score ではなく margin である。回転対称は候補が

3 軸 x order なので同じ軸の別 order が 2 位に来ることも多く、その場合の

margin の小ささは「order が決まらない」を意味する(軸は決まっている)。

`table` に全候補が入っているので、軸だけ固定して order を見直せる。

★ 候補は PCA の 3 軸だけ。真の対称軸が主軸のどれとも一致しない形では

見つからず、しかも黙って最良を返す。

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.

Runnable examples (verified samples that actually call this op)

• rotational_symmetry_fold — py -3.11 examples_3d/rotational_symmetry_fold.py

• symmetry — py -3.11 examples_3d/symmetry.py

Ops the type connects to (they accept `primitive` as input)

fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment

Same category (`symmetry`)

detect_reflection_symmetry · reflect_points · reflection_symmetry_score

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

detect_rotational_symmetry — 3D symmetry op