signed_surface_distance — SHAPESTAT `deviation` op

• 数据种类:points × points → signal

• 调用: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 が出した穴。

法線を省くと :func: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。

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

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

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

• (暂无)

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

shape_reconstruct

同类别(`deviation`)

—

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

signed_surface_distance — SHAPESTAT deviation op

用法