Git Product home page Git Product logo

parametric-t2-spiral's Introduction

Parametric T2 relaxometry for myelin water quantification using T2-spiral data

The current implementation is written in Python 3

Install dependencies ๐Ÿ”ง

- numpy
- nibabel
- matplotlib
- scipy
- skimage
- joblib
- multiprocessing
- progressbar2
- joypy
- pandas
- tabulate

Help ๐Ÿ“–

Open a terminal and write:

$ python call_estimation_script.py -h

usage: call_estimation_script.py [-h] --path_to_folder PATH_TO_FOLDER --input INPUT --mask MASK --denoise {TV2D,TV3D,None} [--reg_param REG_PARAM] --savefig {yes,no} --savefig_slice SAVEFIG_SLICE
                                 [--numcores NUMCORES]

Myelin Water Imaging

optional arguments:
  -h, --help            show this help message and exit
  --path_to_folder PATH_TO_FOLDER
                        Path to the folder where the data is located, e.g., /home/Datasets/T2spiral/
  --input INPUT         Input data, e.g., Data.nii.gz
  --mask MASK           Brain mask, e.g., Mask.nii.gz
  --denoise {TV2D,TV3D,None}
                        Denoising method
  --reg_param REG_PARAM
                        Regularization parameter for TV denoising
  --savefig {yes,no}    Save reconstructed maps in .png
  --savefig_slice SAVEFIG_SLICE
                        Axial slice to save reconstructed maps, e.g., --Slice=90
  --numcores NUMCORES   Number of cores used in the computation: -1 = all cores

For more details see the example script: script_run_T2spiral_fitting_example.sh ๐ŸŽ We included some optional pre- and post-processing steps using FSL (https://fsl.fmrib.ox.ac.uk/fsl/fslwiki):

- Brain extraction for obtaining the brain mask (i.e., bet, FSL)
- Bias-field correction of the estimated proton density map, and segmentation to obtain WM, GM, and CSF probabilistic tissue-maps (i.e., fast, FSL)

Estimated maps ๐Ÿš€

The software will save the following metrics derived from the three-compartment model:

- MWF.nii.gz: Myelin Water Fraction
- IEWF.nii.gz: Intra- and Extra-cellular Water Fraction
- FWF.nii.gz: Free and quasi-free Water Fraction (i.e., T2 > 200ms) 
- T2_M.nii.gz: T2 of the myelin water.
- T2_IE.nii.gz: T2 of the intra- and extra-cellular water
- K_global.nii.gz: It is proportional to the Proton density (i.e., total water content)
- Predicted_Data4D.nii.gz: Predicted signal

References โœ’๏ธ

  • T2prep Three-Dimensional Spiral Imaging with Efficient Whole Brain Coverage for Myelin Water Quantification at 1.5 Tesla Thanh D. Nguyen, Cynthia Wisnieff, Mitchell A. Cooper, Dushyant Kumar, Ashish Raj, Pascal Spincemaille, Yi Wang, Tim Vartanian, and Susan A. Gauthier Magnetic Resonance in Medicine 67:614โ€“621 (2012)

  • Feasibility and Reproducibility of Whole Brain Myelin Water Mapping in 4 Minutes Using Fast Acquisition with Spiral Trajectory and Adiabatic T2prep (FAST-T2) at 3T Thanh D. Nguyen, Kofi Deh, Elizabeth Monohan, Sneha Pandya, Pascal Spincemaille, Ashish Raj, Yi Wang, and Susan A. Gauthier Magn Reson Med. 2016 August ; 76(2): 456โ€“465. doi:10.1002/mrm.25877.

  • Suppression of MRI Truncation Artifacts Using Total Variation Constrained Data Extrapolation Kai Tobias Block, Martin Uecker, and Jens Frahm International Journal of Biomedical Imaging, Volume 2008, Article ID 184123, doi:10.1155/2008/184123

Copyright and license ๐Ÿ“„

GNU Lesser General Public License v2.1

Primarily used for software libraries, the GNU LGPL requires that derived works be licensed under the same license, but works that only link to it do not fall under this restriction.

parametric-t2-spiral's People

Contributors

ejcanalesr avatar

Watchers

 avatar

Forkers

marioocampo

parametric-t2-spiral's Issues

Update dependency

Hello Erick,
I hope you are doing well.

We tried to use the function call_estimation_script.py and we had the error

AttributeError: module 'progressbar' has no attribute 'progressbar'

We solved it installing progressbar2.

I'm creating the issue in case someone else has this error.

Best regards
Mario

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.