signed_surface_distance — SHAPESTAT `deviation` op

• 数据种类:points × points → signal

• 调用: import fullseye as fs; fs.ledger.signed_surface_distance(query, surface, surface_normals=None, k: 'int' = 1)(要直接调用实现,import shapestats; shapestats.signed_surface_distance(query, surface, surface_normals=None, k: 'int' = 1);从台账取用则 opsshapestat.get("signed_surface_distance"))

用法

查询点到曲面的带符号距离。→ (N,)。

符号由面的法线决定(外侧为正)。1-D 轮廓有 profileops.profile_deviation，而 3-D 却没有相应的东西 —— 这是 2026-09-06 PoC 暴露出的漏洞。

省略法线时用 normals_orient.estimate_oriented_normals 估计 —— 若不带朝向，符号会逐点散乱(朴素的 PCA 法线符号任意，旋转后 4 成会翻面。与 pointcloud.fpfh 踩过的是同一个坑)。

k 是确定符号时使用的最近邻个数。为 1 时就是押注于最近邻 1 点的法线，在有噪声的面上符号会跳变。设为 2 以上时，按距离加权的平均朝向来决定(距离本身仍取最近邻)。

详细使用指南

• shape_statistics 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• poc_am_thermal_to_ct — py -3.11 examples/poc_am_thermal_to_ct.py

• shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py

类型可衔接的下一个算子(可接受 `signal` 作为输入)

shape_reconstruct

同类别(`deviation`)

—

*Provenance: shapestats.py — SHAPESTAT 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

signed_surface_distance — SHAPESTAT deviation op

用法