vol_crop_domain — 3D `domain` op

• Datenarten: voxel → voxel

• Aufruf: import fullseye as fs; fs.ledger.vol_crop_domain(vol, domain=None, margin=0) (die Implementierung direkt: import volops; volops.vol_crop_domain(vol, domain=None, margin=0); aus dem Register: ops3d.get("vol_crop_domain"))

• Rückgabewert über das Register: fullseye.ledger.vol_crop_domain(...) 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.vol_crop_domain.raw(...) oder rufe volops.vol_crop_domain direkt auf.

• Rückgabe der Funktion: (part, offset)

Verwendung

Beschneidet ein Volumen auf die enge Bounding Box einer Domain (HALCON crop_domain).

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

This is the memory lever of the domain family: a 512**3 CT scan whose part of interest fits in 128**3 costs 64x less memory and compute once cropped — and the Hessian operators (vol_frangi / vol_sato), capped at MAX_EIGEN_VOXELS, often become *possible* only after this step. Gray values inside the box are kept verbatim (the box, not the mask, defines the crop — pair with vol_reduce_domain first if voxels outside the mask but inside the box must read 0).

*domain* defaults to the volume's own non-zero support (vol != 0 — a gray volume is cropped to wherever it has any signal; note this differs from the > 0.5 convention used when an explicit binary *domain* is passed). *margin* is forwarded to vol_bounding_box.

Returns (cropped, offset) — the (d, h, w) float64 sub-volume and the (z0, y0, x0) voxel offset of its origin in the input frame. Keep the

offset: vol_uncrop maps results back, and vol_boundary_points accepts it as *origin* so point coordinates stay in the uncropped frame. An empty domain raises ValueError (fail-closed).

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)

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

vol_reduce_domain · vol_bounding_box · vol_uncrop · vol_tiled_map

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

vol_crop_domain — 3D domain op