symmetry op• 数据种类:points → measurement
• 调用: import fullseye as fs; fs.ledger.reflection_symmetry_score(points, plane_point, plane_normal)(要直接调用实现,import symmetry3d; symmetry3d.reflection_symmetry_score(points, plane_point, plane_normal);从台账取用则 ops3d.get("reflection_symmetry_score"))
反射对称得分 = chamfer(镜像, 原) / 最近邻间距中位数(越小越对称,尺度不变)。→ float。
用 reflect_points 将点云关于平面做镜像，计算与原点云的对称 Chamfer 距离(chamfer_distance:
双向最近邻距离均值的均值)，再除以原点云最近邻间距的中位数。这是“镜像相对原始点偏离了几倍点间距”的无量纲量，因此坐标乘以常数倍后值不变。
• points:(N,3) 点云。plane_point / plane_normal:候选平面(法线在内部归一化)。
• fail-closed(失败即拒绝)：点云为空、不是 (N,3)(chamfer_distance 抛出 ValueError)、所有点重合导致间距无法定义(ValueError)。仅当重复点使中位数间距为 0 时，以到质心的 RMS 半径 × 1e-12 作为下限。
阅读注意：即使是严格对称的形状，镜像点也不会与原始采样点完全重合，因此分数不会为 0，而是以点间距左右为下限(实测值见 detect_reflection_symmetry 的表)。与其用阈值决定取舍，不如扫掠多个候选，看最小值及其与第 2 名之差(margin)。想尝试 PCA 3 轴以外的候选面时，直接用平面参数扫掠本函数。
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• dl_mesh_symmetry — py -3.11 examples_3d/dl_mesh_symmetry.py
• reflection_symmetry — py -3.11 examples_3d/reflection_symmetry.py
measurement 作为输入)vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle
symmetry)detect_reflection_symmetry · detect_rotational_symmetry · reflect_points
*Provenance: symmetry3d.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.