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

用法