httomolibgpu.prep.phase

`httomolibgpu.prep.phase`#

Modules for phase retrieval and phase-contrast enhancement. For more detailed information, see Phase-contrast enhancement.

httomolibgpu.prep.phase.paganin_filter(tomo: <cp.ndarray>, pixel_size: float = 1.28, distance: float = 1.0, energy: float = 53.0, ratio_delta_beta: float = 250) → <cp.ndarray>[source]#

Perform single-material phase retrieval from flats/darks corrected tomographic measurements. For more detailed information, see Phase-contrast enhancement. Also see [6] and [7] for references.

Parameters:

tomo (cp.ndarray) – 3D array of f/d corrected tomographic projections.
pixel_size (float) – Detector pixel size (resolution) in micron units.
distance (float) – Propagation distance of the wavefront from sample to detector in metre units.
energy (float) – Beam energy in keV.
ratio_delta_beta (float) – The ratio of delta/beta, where delta is the phase shift and real part of the complex material refractive index and beta is the absorption.

Returns:

The 3D array of Paganin phase-filtered projection images.

Return type:

cp.ndarray

httomolibgpu.prep.phase.paganin_filter_savu_legacy(tomo: <cp.ndarray>, pixel_size: float = 1.28, distance: float = 1.0, energy: float = 53.0, ratio_delta_beta: float = 250) → <cp.ndarray>[source]#

Perform single-material phase retrieval from flats/darks corrected tomographic measurements. For more detailed information, see Phase-contrast enhancement. Also see [6] and [7] for references. The ratio_delta_beta parameter here follows implementation in Savu software. The module will be retired in future in favour of paganin_filter. One can rescale parameter ratio_delta_beta / 4 to achieve the same effect in paganin_filter.