vol_gamma — 3D gray op

• Data kinds: voxel → voxel

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

उपयोग

volume की अपनी range पर gamma (power-law) correction (HALCON pow_image)।

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

Normalises [min, max] to [0, 1], applies t**gamma, and maps the result back to the original [min, max] — so the volume's extremes are fixed points and only the mid-tones move: gamma > 1 darkens them, gamma < 1 brightens them, gamma == 1 is the identity. The transform is strictly monotone, so intensity *ordering* is always preserved.

A constant volume is returned unchanged (no range to normalise — see the module docstring's flat-volume note).

Parameters

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

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

gamma : float

Exponent, > 0 (fail-closed: gamma <= 0 is not a monotone

intensity map).

Returns

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

The gamma-corrected volume, same [min, max] range as the input.

Raises

ValueError

Non-3-D / non-finite input, or gamma <= 0.

संदर्भ (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_stretch


*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.