lcat_denoising¶
-
nighres.intensity.
lcat_denoising
(image_list, image_mask, phase_list=None, ngb_size=3, ngb_time=10, stdev_cutoff=1.05, min_dimension=0, max_dimension=-1, save_data=False, overwrite=False, output_dir=None, file_names=None)[source]¶ LCaT denoising
Denoise multi-contrast time series data with a local PCA-based method
Parameters: - image_list ([niimg]) – List of input 4D magnitude images to denoise
- image_mask (niimg) – 3D mask for the input images
- phase_list ([niimg]) – List of input 4D phase images to denoise (optional)
- ngb_size (int, optional) – Size of the local PCA neighborhood, to be increased with number of inputs (default is 3)
- ngb_time (int, optional) – Size of the time window to use (default is 10)
- stdev_cutoff (float, optional) – Factor of local noise level to remove PCA components. Higher values remove more components (default is 1.05)
- min_dimension (int, optional) – Minimum number of kept PCA components (default is 0)
- max_dimension (int, optional) – Maximum number of kept PCA components (default is -1 for all components)
- 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_names ([str], optional) – Desired base names for output files with file extension (suffixes will be added)
Returns: Dictionary collecting outputs under the following keys (suffix of output files in brackets)
- denoised ([niimg]): The list of denoised input images (_lcat_den)
- dimensions (niimg): Map of the estimated local dimensions (_lcat_dim)
- residuals (niimg): Estimated residuals between input and denoised images (_lcat_err)
Return type: Notes
Original Java module by Pierre-Louis Bazin. Algorithm inspired by [1] with a different approach to set the adaptive noise threshold and additional processing to handle the time series properties.
References
[1] Manjon, Coupe, Concha, Buades, Collins, Robles (2013). Diffusion Weighted Image Denoising Using Overcomplete Local PCA doi:10.1371/journal.pone.0073021