mp2rageme_pd_mapping

nighres.intensity.mp2rageme_pd_mapping(first_inversion, second_inversion, t1map, r2smap, echo_times, inversion_times, flip_angles, inversion_TR, excitation_TR, N_excitations, efficiency=0.96, uni=None, b1map=None, b1scaling=1.0, save_data=False, overwrite=False, output_dir=None, file_name=None)[source]

MP2RAGEME PD mapping

Estimate PD maps from MP2RAGEME data, combining T1 and R2* estimates with the MPRAGE model of [1] .

Parameters:
  • first_inversion ([niimg]) – List of {magnitude, phase} images for the first inversion
  • second_inversion ([niimg]) – List of {magnitude, phase} images for the second inversion
  • t1map (niimg) – Quantitative T1 map image, in seconds
  • r2smap (niimg) – Quantitative R2* map image, in Hz
  • echo_times ([float]) – List of {te1, te2, te3, te4, te5} echo times, in seconds
  • inversion_times ([float]) – List of {first, second} inversion times, in seconds
  • flip_angles ([float]) – List of {first, second} flip angles, in degrees
  • inversion_TR (float) – Inversion repetition time, in seconds
  • excitation_TR ([float]) – List of {first,second} repetition times,in seconds
  • N_excitations (int) – Number of excitations
  • efficiency (float) – Inversion efficiency (default is 0.96)
  • uni (niimg) – UNI image to use instead of phase data (optional)
  • b1map (niimg) – Computed B1 map (ratio ~1, optional)
  • b1scaling (float) – B1 map scaling factor (default is 1.0)
  • scale_phase (bool) – Whether to rescale the phase image in [0,2PI] or to assume it is already in radians
  • save_data (bool) – Save output data to file (default is False)
  • overwrite (bool) – Overwrite existing results (default is False)
  • output_dir (str, optional) – Path to desired output directory, will be created if it doesn’t exist
  • file_name (str, optional) – Desired base name for output files with file extension (suffixes will be added)
Returns:

Dictionary collecting outputs under the following keys (suffix of output files in brackets)

  • pd (niimg): Map of estimated proton density ratio (_qpd-map)
Return type:

dict

Notes

Original Java module by Pierre-Louis Bazin.

References

[1]Marques, Kober, Krueger, van der Zwaag, Van de Moortele, Gruetter (2010) MP2RAGE, a self bias-field corrected sequence for improved segmentation and T1-mapping at high field. doi: 10.1016/j.neuroimage.2009.10.002.