Skip to content

Slicer extension for MP2RAGE-specific processing.

License

Notifications You must be signed in to change notification settings

harellab/SlicerUHFMRTools

Repository files navigation

SlicerUHFMRTools

This is an extension for 3D Slicer that provides tools for working with ultra-high field (UHF) MRI images and is intended to provide post-acquisition processing. These tools are meant to aid in the post-processing for existing MRI pipelines.

Currently, there is an MP2RAGE background noise suppression (aka denoising) module using MP2RAGE contrast images. The MP2RAGE MRI contrast1 is acquired by simultaneously collecting two MPRAGE images at different inversion times and combining them to form a new, derived contrast. MP2RAGE generates excellent T1-weighted images and is useful for generating other derived contrasts (e.g. T1 maps, synthetic white matter-nulled T1s, and synthetic FGATIR2). However, it contains “salt-and-pepper” noise, rather than zero values, in areas of low or no signal. This noise can cause algorithms developed for traditional T1 images processing to fail. A “denoising” (more accurately, background suppression) method for eliminating such noise has been published3, but it relies on additional phase data which is typically not available. This extension implements a method for retrospectively applying a similar noise suppression approach which relies only on available scanner output images.

Installation Instructions

  1. In Slicer, open the Extensions Manager (View → Extensions Manager).

  2. Search for UHFMRTools and click INSTALL

  3. Restart Slicer.

Alternate Installation Method: Manual Installation Via Github

For development and testing, the extension may also be installed from the project's GitHub repository.

  1. Open a terminal, change directory to the path that you will input into Step 3, and type into the command line:

    git clone [email protected]:harellab/SlicerUHFMRTools.git

  2. Open Slicer and go to Edit → Application Settings → Modules

  3. Copy the mp2rageBackgroundSuppression directory path into the Additional module paths and click ok

    Note: the module path will be the directory where the github was cloned with ~/SlicerUHFMRTools-Trunk/BackgroundNoiseSuppression Alt text

  4. Restart Slicer and go back to Edit → Application Settings → Modules. Make sure the BackgroundNoiseSupression module checkbox is checked, click and drag the module to the Favorite Modules list. Alt text

Usage

Required Inputs:

  1. MP2RAGE uniform images (UNI)
  2. The first inversion recovery sequence (INV1) from MP2RAGE
  3. The second inversion recovery sequence (INV2) from MP2RAGE

Extension Workflow:

  1. Load the MP2RAGE data sets (UNI, INV1, INV2) into 3D Slicer as volumes. Alt text

  2. Select the corresponding UNI, INV1, and INV2 volumes. The supression strength is normalized relative to an estimated noise variance calculated at the corner of the image. The default suppression strength is set at 1000; useful suppression strength may scale several orders of magnitude. Higher suppression strength trades increased background noise suppression for increased bias field effects.

  3. To filter the background noise, create a new volume or select an existing volume. Alt text

Disclaimer

UHFMRTools, same as 3D Slicer, is a research software. It is NOT an FDA-approved medical device. It is not intended for clinical use. The user assumes full responsibility to comply with the appropriate regulations.

Support

Please feel free to contact The Harel Lab github organization for questions, feedback, suggestions or bugs. https://github.com/harellab/SlicerUHFMRTools/issues

Acknowledgments

Development of UHFMRTools was supported in part by the following NIH grants: Udall NIH P50 NS123109

References

1. Marques JP, Kober T, Krueger G, Van Der Zwaag W, Van De Moortele PF, Gruetter R. MP2RAGE, a self bias-field corrected sequence for improved segmentation and T1-mapping at high field. NeuroImage. 2010;49(2):1271-1281. doi:10.1016/j.neuroimage.2009.10.002

2. Middlebrooks EH, Tao S, Zhou X, et al. Synthetic Inversion Image Generation using MP2RAGE T1 Mapping for Surgical Targeting in Deep Brain Stimulation and Lesioning. Ster Funct Neurosurg. 2023;101(5):326-331. doi:10.1159/000533259

3. O’Brien KR, Kober T, Hagmann P, et al. Robust T1-Weighted Structural Brain Imaging and Morphometry at 7T Using MP2RAGE. Margulies D, ed. PLoS ONE. 2014;9(6):e99676. doi:10.1371/journal.pone.0099676