distance_ridge — 3D `medial` op

• Datenarten: voxel → voxel

• Aufruf: import fullseye as fs; fs.ledger.distance_ridge(vol, min_radius=0.0) (die Implementierung direkt: import medial; medial.distance_ridge(vol, min_radius=0.0); aus dem Register: ops3d.get("distance_ridge"))

• Rückgabewert über das Register: fullseye.ledger.distance_ridge(...) liefert **nur den Wert des deklarierten Out-Typs voxel** (die zugrunde liegende Funktion gibt zusätzlich Hilfsinformationen zurück). Wird das Verworfene gebraucht, nutze fullseye.ledger.distance_ridge.raw(...) oder rufe medial.distance_ridge direkt auf.

• Rückgabe der Funktion: (ridge, dist)

Verwendung

Extrahiert den Grat der EDT (die lokalen Maxima des Distanzfeldes) als Medialachse. Liefert (ridge_mask, edt).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

各前景 voxel の EDT を計算し、26 近傍の局所極大(自分の EDT が周囲 26 voxel の最大以上)を

medial とみなす。この基準は物体の局所次元に応じて自然に次元を出し分ける:

塊(球) -> EDT が単峰 -> 点状の medial(中心 1 点)。

管(円柱)-> 軸方向に平坦・半径方向に単峰 -> 線状の medial(軸線)。

板(スラブ)-> 面内で平坦・厚み方向に単峰 -> 面状の medial(中心面)。

境界 voxel は内側の隣が必ず大きいため極大にならず、外殻は自然に除かれる。平坦な尾根

(軸/面)は同値の隣接を許容(>=)することで連続した線/面として残る。

Args:

vol: バイナリ voxel(bool / 0-1 の 3D)。

min_radius: この EDT 値以下の弱い尾根を捨てる閾値(既定 0 = 捨てない)。ノイズ抑制用。

Returns:

ridge_mask (bool 3D): medial voxel。

edt (float64 3D): 各 voxel の背景までのユークリッド距離(= 局所半径)。

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.

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

• pcl_geodesic — py -3.11 examples_3d/pcl_geodesic.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

Gleiche Kategorie (`medial`)

skeletonize_vol · medial_axis_points · topology_signature · medial_match · skeleton_junctions3d · skeleton_endpoints3d · skeleton_prune3d · skeleton_branches3d

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

distance_ridge — 3D medial op