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:

dict

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