signed_surface_distance — SHAPESTAT `deviation` op

• Datenarten: points × points → signal

• Aufruf: import shapestats; shapestats.signed_surface_distance(query, surface, surface_normals=None, k: 'int' = 1) (oder opsshapestat.get("signed_surface_distance"))

Verwendung

> Für diesen Operator gibt es noch keine Übersetzung. Es folgt der Originaltext unverändert.

問い合わせ点から面までの符号つき距離。→ `(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 以上にすると距離で重みを付けた

平均の向きで決める(距離そのものは最近傍のまま)。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie shape_statistics

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• (noch keine)

Typkompatible Folge-Operatoren (nehmen `signal` als Eingabe)

shape_reconstruct

Gleiche Kategorie (`deviation`)

—

*Provenance: shapestats.py — SHAPESTAT Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

signed_surface_distance — SHAPESTAT deviation op