vol_bounding_box — 3D `domain` op

• Data kinds: voxel → primitive

• Call: import fullseye as fs; fs.ledger.vol_bounding_box(domain, margin=0) (to call the implementation directly, import volops; volops.vol_bounding_box(domain, margin=0); from the registry, ops3d.get("vol_bounding_box"))

Usage

Tight axis-aligned bounding box of a mask's foreground, in voxel indices.

Returns `(z0, y0, x0, z1, y1, x1)` with exclusive upper bounds, i.e.

`vol[z0:z1, y0:y1, x0:x1]` is the smallest sub-volume containing every

foreground voxel. *margin* (an int `>= 0`) grows the box by that many

voxels per side, clipped to the volume — headroom for operators with a

spatial footprint (a Gaussian of sigma s needs ~`3*s` voxels of context).

A non-`{0, 1} input is thresholded at > 0.5`.

An empty mask raises `ValueError` (fail-closed): there is no box, and

silently returning the full volume would defeat the point of cropping.

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

Runnable examples (verified samples that actually call this op)

• rle_region_efficiency — py -3.11 examples_3d/rle_region_efficiency.py

• roi_domain_boundary — py -3.11 examples_3d/roi_domain_boundary.py

Ops the type connects to (they accept `primitive` as input)

fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment

Same category (`domain`)

vol_reduce_domain · vol_crop_domain · vol_uncrop · vol_tiled_map

*Provenance: volops.py — 3D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

vol_bounding_box — 3D domain op