vol_gradient_magnitude — 3D `feature` op

• Datenarten: voxel → voxel

• Aufruf: import fullseye as fs; fs.ledger.vol_gradient_magnitude(vol) (die Implementierung direkt: import volops; volops.vol_gradient_magnitude(vol); aus dem Register: ops3d.get("vol_gradient_magnitude"))

Verwendung

3-D-Sobel-Gradientenbetrag sqrt(gz**2 + gy**2 + gx**2).

Jedes g* ist eine scipy.ndimage.sobel-Ableitung entlang einer Achse. Die Antwort konzentriert sich an Intensitätsgrenzen (eine Stufenkante leuchtet an der Grenzfläche auf und ist in flachen Bereichen etwa 0). Gibt ein (D, H, W) float64-Volume zurück.

Berechnung: scipy.ndimage.sobel wird nacheinander entlang axis 0 (z), 1 (y), 2 (x) angewandt, und sqrt(gz**2 + gy**2 + gx**2) wird zurückgegeben. Sobel ist ein separierbarer Kernel aus Ableitung [-1,0,1] und Glättung [1,2,1] (je 4-fach auf den 2 orthogonalen Achsen), daher ist die Antwort auf eine Einheitsstufe (0→1) senkrecht zu einer Achse nicht 1, sondern 16 (16.0 auf den 2 Voxeln beiderseits der Grenzfläche, 0 in flachen Bereichen; scipy-Standard- gewichte, Rand mode='reflect'). Die Werte werden nicht normiert (sie passen nicht in [0, 1]). spacing wird nicht angenommen; Differenzen in Voxeleinheiten (auch bei anisotropen Voxeln keine Korrektur pro Achse).

Prüfung (ValueError): nicht 3-D / enthält NaN oder Inf / Voxelanzahl überschreitet MAX_VOXELS (1 << 27).

Einsatz: Gelände-Eingabe (landscape) für vol_watershed, Grate der Grenzfläche mit vol_local_maxima aufnehmen, mit vol_stretch auf [0, 1] normieren und anzeigen.

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)

• vessel_metrology — py -3.11 examples_3d/vessel_metrology.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 (`feature`)

sobel3d · hessian3d · curvature_maps · edt_jfa · edt_jfa_vector · vol_frangi · vol_local_std · vol_local_thickness

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

vol_gradient_magnitude — 3D feature op