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 (:func:vol_frangi / :func: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 :func: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 :func: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: :func:vol_uncrop maps results back, and

:func: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