symmetry op• データ種: points → primitive
• 呼び出し: import fullseye as fs; fs.ledger.detect_rotational_symmetry(points, orders=(2, 3, 4, 6, 8)) (実装を直接呼ぶなら import symmetry3d; symmetry3d.detect_rotational_symmetry(points, orders=(2, 3, 4, 6, 8))、台帳から引くなら ops3d.get("detect_rotational_symmetry"))
PCA 主軸を候補軸として最良の回転対称(軸 × order)を選ぶ。
→ 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 軸だけ。真の対称軸が主軸のどれとも一致しない形では
見つからず、しかも黙って最良を返す。
• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。
• rotational_symmetry_fold — py -3.11 examples_3d/rotational_symmetry_fold.py
• symmetry — py -3.11 examples_3d/symmetry.py
primitive を入力に取れる)fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment
symmetry)detect_reflection_symmetry · reflect_points · reflection_symmetry_score
*Provenance: symmetry3d.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.