Tasks

class cest.tasks.WASSR(image, meta_data, wassr, delta_ppm=0.001, ppm_range=None)

Compute a Z-spectrum shift map using the WASSR method.

Parameters:

  • image (path_like) – Path to the source Z-spectrum image

  • meta_data (path_like) – Path to the meta-data related to the source image

  • wassr (path_like) – Path to the target WASSR map

  • delta_ppm (float, optional) – Interpolation step

  • ppm_range (pair_of_floats, optional) – Range over which to interpolate the Z-spectrum, defaults to full range defined by meta-data.

References

Water saturation shift referencing (WASSR) for chemical exchange saturation transfer (CEST) experiments, Kim et al., Magnetic Resonance in Medicine 61(6), 2009. doi:10.1002/mrm.21873.

class cest.tasks.ShiftSpectrum(image, meta_data, B0, shifted)

Shift a Z-spectrum as described in the WASSR method.

Parameters:

  • image (path_like) – Path to the source Z-spectrum image

  • meta_data (path_like) – Path to the meta-data related to the source image

  • B0 (path_like) – Path to the frequency shift map

  • shifted (path_like) – Path to the target shifted Z-spectrum

References

Water saturation shift referencing (WASSR) for chemical exchange saturation transfer (CEST) experiments, Kim et al., Magnetic Resonance in Medicine 61(6), 2009. doi:10.1002/mrm.21873.

class cest.tasks.Refine(z_spectrum, meta_data, ppms, refined)

Interpolate a Z-spectrum.

Parameters:

  • z_spectrum (path_like) – Path to the source Z-spectrum image

  • meta_data (path_like) – Path to the meta-data related to the source image

  • ppms (array_like) – Target frequencies

  • refined (path_like) – Path to the target interpolated Z-spectrum

class cest.tasks.MTR(z_spectrum, ppms, mtr, normalization='normref')

Compute an MTR map.

Parameters:

  • z_spectrum (path-like or image or array) – Source Z-spectrum data. It must be path-like if used as a task, otherwise it may be a nibabel image or a numpy array.

  • ppms (path-like or array) – PPM values of the z-spectrum. If path-like, the values will be loaded from the path. The PPM values must be symmetric with respect to 0.

  • mtr (path-like, optional) – Path to the target MTR image. It is optional only when used as a function.

  • normalization (string, optional) – Normalization method, must be one of asym, normref (default value), pcm, rex

Returns:

MTR data, only applicable when used as a function.

Return type:

array or image

References

Inverse Z-spectrum analysis for spillover-, MT-, and T1-corrected steady-state pulsed CEST-MRI – application to pH-weighted MRI of acute stroke. Zaiss et al. NMR in Biomedicine 27(3), 2014. doi:10.1002/nbm.3054.