vol_stretch — 3D gray op

• Data kinds: voxel → voxel

• Call: import fullseye as fs; fs.ledger.vol_stretch(vol, p_low=1.0, p_high=99.0) (implementation को सीधे call करना हो तो import volgray; volgray.vol_stretch(vol, p_low=1.0, p_high=99.0), registry से लेना हो तो ops3d.get("vol_stretch"))

उपयोग

[0, 1] तक percentile contrast stretch (robust scale_image_max)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Computes the *p_low*-th and *p_high*-th intensity percentiles and maps [P(p_low), P(p_high)] linearly onto [0, 1], clipping outside — so a handful of hot/cold outlier voxels (a metal artefact, a dead detector element) no longer dictates the display range, unlike a plain min/max normalisation. The defaults (1 % / 99 %) are the usual display-stretch choice.

If the two percentile values coincide (a constant — or near-constant — volume), the input is returned unchanged rather than divided by zero (see the module docstring's flat-volume note).

Parameters

vol : array_like, shape (D, H, W)

Input volume (coerced to float64; NaN/Inf rejected).

p_low, p_high : float

Percentiles in [0, 100] with p_low < p_high (fail-closed).

Returns

ndarray, shape (D, H, W), float64

The stretched volume in [0, 1] (degenerate percentiles: the input

itself).

Raises

ValueError

Non-3-D / non-finite input, percentiles out of [0, 100], or

p_low >= p_high.

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• gray_window_level — py -3.11 examples_3d/gray_window_level.py

वे अगले ops जिनसे type जुड़ता है (voxel को input के रूप में लेते हैं)

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

इसी category के (gray)

vol_window_level · vol_equalize · vol_gamma


*Provenance: volgray.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.