Skip to main content

Denoising method for sequence of images or volumes. Primarly targeting fMRI data.

Project description

COVERAGE CI CD DOC RELEASE PYVERSION

LINTER STYLE LICENSE CITATION

This repository implements patch-denoising methods, with a particular focus on local-low rank methods.

The target application is functional MRI thermal noise removal, but this methods can be applied to a wide range of image modalities.

It includes several local-low-rank based denoising methods (see the documentation for more details):

  1. MP-PCA

  2. Hybrid-PCA

  3. NORDIC

  4. Optimal Thresholding

  5. Raw Singular Value Thresholding

A mathematical description of theses methods is available in the documentation.

Installation

patch-denoise requires Python>=3.8

Quickstart

After installing you can use the patch-denoise command-line.

$ patch-denoise input_file.nii output_file.nii --mask="auto"

See patch-denoise --help for detailled options.

Documentation and Examples

Documentation and examples are available at https://paquiteau.github.io/patch-denoising/

Development version

$ git clone https://github.com/paquiteau/patch-denoising
$ pip install -e patch-denoising[dev,doc,test,optional]

Citation

If you use this package for academic work, please cite the associated publication, available on HAL

@inproceedings{comby2023,
  TITLE = {{Denoising of fMRI volumes using local low rank methods}},
  AUTHOR = {Pierre-Antoine, Comby and Zaineb, Amor and Alexandre, Vignaud and Philippe, Ciuciu},
  URL = {https://hal.science/hal-03895194},
  BOOKTITLE = {{ISBI 2023 - International Symposium on Biomedical Imaging 2023}},
  ADDRESS = {Carthagena de India, Colombia},
  YEAR = {2023},
  MONTH = Apr,
  KEYWORDS = {functional MRI ; patch denoising ; singular value thresholding ; functional MRI patch denoising singular value thresholding},
  PDF = {https://hal.science/hal-03895194/file/isbi2023_denoise.pdf},
  HAL_ID = {hal-03895194},
  HAL_VERSION = {v1},
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

patch-denoise-1.3.1.tar.gz (38.6 kB view hashes)

Uploaded Source

Built Distribution

patch_denoise-1.3.1-py3-none-any.whl (31.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page