reflect_points — 3D symmetry op

• 資料種類:points → points

• 呼叫: import fullseye as fs; fs.ledger.reflect_points(points, plane_point, plane_normal)(要直接呼叫實作,import symmetry3d; symmetry3d.reflect_points(points, plane_point, plane_normal);從台帳取用則 ops3d.get("reflect_points"))

用法

把點群關於平面(點 plane_point、法線 plane_normal)鏡像。→ (N,3)。

取各點 p 到平面的有號距離 d = (p - plane_point) · n(n 為正規化後的法線)，回傳 p' = p - 2 d n(Householder 鏡射)。平面上的點不動，平面兩側的點互換。點的順序保持不變，因此 p'[i] 是 p[i] 的鏡像。座標單位不變。

• points:(N,3) 陣列(轉換為 float)。不做形狀檢查。

• plane_point:平面上的 1 個點 (3,)。plane_normal:法線 (3,)(長度任意，內部正規化。符號不影響結果)。

注意：法線是除以範數加 1e-12，因此即使傳入零向量也不會拋出例外，點雲幾乎原樣回傳(不是 fail-closed(失敗即拒絕))。除了在 reflection_symmetry_score / detect_reflection_symmetry 內部使用外，也可用於以偵測到的對稱面填補缺失側(將鏡像串接到原點雲上)的形狀補全。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• reflection_symmetry — py -3.11 examples_3d/reflection_symmetry.py

型別可銜接的下一個運算子(可接受 points 作為輸入)

points_to_voxel · gaussians_to_voxel · estimate_point_normals · to_points · match_points_ncc · match_pca · moment_axes · icp_point2point_3d

同類別(symmetry)

detect_reflection_symmetry · detect_rotational_symmetry · reflection_symmetry_score

*Provenance: symmetry3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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