Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up

License

NotificationsYou must be signed in to change notification settings

delucaal/MRIToolkit

Repository files navigation

MRIToolkit [Update 11-12-2024 v1.7]

What is it?

MRIToolkit is a set ofcommand line tools and a MATLAB (R) toolbox to process (diffusion) magnetic resonance imaging (MRI) data. Binaries of the command line version will be provided at some point!

The idea behind MRIToolkit is to integratemy research output with existing state-of-the-art methods for (diffusion) MRI processing.

Where do I find it?

Explore the main functionalities:

The toolbox is referenced for the first time inGuo et al.. Additionally, please cite the original works corresponding to the steps you use:

Quick installation

Please, seethis guide

  • I have coded most functions to accept Python-like name/value argument couples. To know which arguments to specify, just try the MATLAB help as, for instance, "help EDTI.LoadNifti"
  • The file naming convention is to always indicate Niftis as .nii, even when they are actually compressed in .nii.gz. The code takes care of that, but expects only .nii as arguments in function calls!

Getting started

Examples of some functionalities can be found inhere

Requirements:
  • MRIToolkit relies on a couple of third party dependencies:
    • Elastix:
        1. Either compile your own version or grab the executables for your platformhere.
        1. Copy the file "TemplateMRIToolkitDefineLocalVars.m" to your MATLAB default folder (user/MATLAB or Documents/MATLAB), rename the file as "MRIToolkitDefineLocalVars.m".
        1. Edit the script, adjusting the variable MRIToolkit.Elastix.Location as needed.
    • NODDI toolbox: if you would like to try the mFOD method, you will need to add theNODDI toolbox to the MATLAB path.
    • ExploreDTI: While MRIToolkit is entirely self-sufficient (e.g. all needed ExploreDTI functions are bundled and adapted), the visualization of fiber tractograhy and other results will need ExploreDTI. Get it for free fromAlexander Leemans.
Notes:
  • MRIToolkit is NOT approved for clinical use
  • This code is a work in progress. It will be updated without notice to ensure bug-fixes and the inclusion of best available methods
License:
Keywords:
  • Magnetic Resonance Imaging (MRI)
  • Image segmentation
  • T1 quantification, Inversion Recovery
  • T2 quantification, spin echo multi echo
  • Extended Phase Graphs
  • Diffusion MRI (dMRI) - Diffusion Tensor Imaging (DTI) - Diffusion Kurtosis Imaging (DKI)
  • dMRI preprocessing - motion correction - eddy currents correction - EPI distortions correction
  • Fiber tractography - Constrained Spherical Deconvolution (CSD) - Generalized Richardson Lucy (GRL) - mFOD
  • Laplacian fit - Spectral Fit - Robust Deconvolution
  • Automatic tractography clustering

Toolbox components [Content to be updated]

Ready to use:
  • 'ExploreDTIInterface': I am pleased to announce that MRIToolkit now contains, distributes and develops many functions originally developed as part ofExploreDTI. They are here available as a consolidated library and are planned to also become command line tools. A big thank toAlexander Leemans and Ben Jeurissen for this!
  • 'SphericalDeconvolution': Methods used for two novel deconvolution methods we developed, namely theGeneralized Richardson Lucy andmFOD. Some of the functions here included have been taken fromHardi Tools of Erick Canales-Rodriguez.
    • 'LesionEditor': a graphical user interface to visualise and edit segmentations of 3D MRI images, originally designed for delineation of multiple-sclerosis lesions on fluid attenuated inversion recovery (FLAIR) images. Requires MATLAB R2018a or newer.Documentation coming soon
  • 'NiftiIO_basic': Basic Nifti input/output, including code originally written byJimmy Shen
  • 'DW_basic': Utilities to load / manipulate / save dMRI data
  • 'OptimizationMethods': Classes and functions for numeric optimisation methods
  • 'Relaxometry': Classes for T1/T2 quantification using inversion-recovery / spin-echo multi-echo data
  • 'ThirdParty': Utilities from third parties used in other scripts. Includes EPG code fromBrian Hargreaves
  • 'ImageRegistrations': Image registration utils based onElastix
  • 'GettingStarted': Small examples showcasing functionalities of MRIToolkit.
Being integrated and coming soon:
  • 'Diffusion_basic': Class for (basic) dMRI quantification

  • 'DW_IVIMDTDK_I': Diffusion MRI fit utilities - IVIM, DT, DKI - used inDe Luca et al. 2017

  • 'Dicom_utils': Tools for handling unconventional or buggy DICOMs

  • 'MixedCodeUtils': 'Useful general purpose functions

  • 'MRIfoundation': Classes for MRI sequences abstraction

  • 'EPG_simulator': Classes for EPG simulations

Not yet planned for release (contact me directly if interested):

Alberto De Luca - First published in 2019


[8]ページ先頭

©2009-2025 Movatter.jp