symmetry op• 資料種類:points → primitive
• 呼叫: import fullseye as fs; fs.ledger.detect_reflection_symmetry(points)(要直接呼叫實作,import symmetry3d; symmetry3d.detect_reflection_symmetry(points);從台帳取用則 ops3d.get("detect_reflection_symmetry"))
在以 PCA 主軸為法線(過重心)的候選平面中選出最佳鏡像對稱面。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
→ dict{plane_point, plane_normal, score, all_scores, margin}。
score が小さいほど対称。
★ **`score だけで採否を決めない。margin` を見ること**(2026-09-06 追加)。
`margin` は 2 位と 1 位の score の差で、候補が団子なら答えはくじ引き
である、という警告になる。実測(1500 点):
================== ======== ======== =========
形状 best 2 位 margin
================== ======== ======== =========
箱(鏡映面が 3 枚) 0.9397 0.9499 0.0102
角柱つきの箱 0.9876 0.9918 0.0043
球 1.0490 1.0551 0.0062
一様乱数の立方体 1.0608 1.3435 0.2828
================== ======== ======== =========
対称面が複数ある形ほど margin は小さい —— これは不具合ではなく、そういう形
だという情報である。点群位置合わせの PoC が同じ構造を測っていて、PCA の
候補は素の直方体で 83 % が反転した象限を掴むが、そのとき先に潰れるのは
残差ではなく候補どうしの margin だった(0.42 → 0.066 → 0.039)。**残差でなく
margin で採否を見る**、が両方に共通する結論。
★ **`score` は 0 に近づかない。** 厳密に対称な形でも点の間隔が床を作る
(上の表で箱が 0.94)。「0 に近いか」ではなく「同じ形を鏡映せずに測った値」や
「点間隔」と比べること。
★ 候補は PCA の 3 軸だけ。真の対称面が主軸のどれとも一致しない形では
見つからず、しかも黙って 3 つのうち最良を返す。密に振った候補が要るなら
`reflection_symmetry_score` を直接掃引すること。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• dl_mesh_symmetry — py -3.11 examples_3d/dl_mesh_symmetry.py
• itokawa_symmetry_honest — py -3.11 examples_3d/itokawa_symmetry_honest.py
• reflection_symmetry — py -3.11 examples_3d/reflection_symmetry.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_rotational_symmetry · reflect_points · reflection_symmetry_score
*Provenance: symmetry3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.