t2s_optimal_combination¶
-
nighres.intensity.
t2s_optimal_combination
(image_list, te_list, depth=None, save_data=False, overwrite=False, output_dir=None, file_name=None)[source]¶ T2*-Optimal Combination
Estimate T2*/R2* and use it to combine multi-echo data
Parameters: - image_list ([niimg]) – List of 4D input images, one per echo time
- te_list ([float]) – List of input echo times (TE)
- depth ([int]) – List of echo depth to keep for input time points
- save_data (bool, optional) – Save output data to file (default is False)
- overwrite (bool, optional) – 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)
- combined (niimg): Optimally combined 4D image
- t2s (niimg): Map of estimated T2* times (_qt2fit-t2s)
- r2s (niimg): Map of estimated R2* relaxation rate (_qt2fit-r2s)
- s0 (niimg): Estimated PD weighted image at TE=0 (_qt2fit-s0)
- residuals (niimg): Estimated residuals between input and estimated echoes (_qt2fit-err)
Return type: Notes
Original Java module by Pierre-Louis Bazin.