Difference between revisions of "DiffusionImaging"

From mitk.org
Jump to navigation Jump to search
(Replaced content with "__NOTOC__ #REDIRECT "MitkDiffusion"")
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
−
 
+
#REDIRECT [["MitkDiffusion"]]
−
== MITK Diffusion ==
 
−
 
 
−
 
 
−
=== Quicklinks ===
 
−
* [[#Features & Highlights|'''Features & Highlights''']]
 
−
* [[#Downloads|'''Installer Downloads''']]
 
−
* [https://phabricator.mitk.org/source/mitk/ '''Source code''']
 
−
* [[#Building MITK Diffusion from source|'''Quick-Build Instructions''']]
 
−
* [http://docs.mitk.org/nightly/org_mitk_gui_qt_diffusionimaging.html '''User Manual''']
 
−
* [[#References|'''References''']]
 
−
* [[#Contact|'''Contact''']]
 
−
 
 
−
 
 
−
=== Features & Highlights ===
 
−
 
 
−
The MITK Diffusion application [1,2] offers a selection of image analysis algorithms for the processing of diffusion-weighted MR images. It encompasses the research of the Division [https://www.dkfz.de/en/mic/index.php Medical Image Computing] at the German Cancer Research Center (DKFZ).
 
−
 
 
−
 
 
−
'''Support for most established image formats'''
 
−
* Images: DICOM, NIFTI, NRRD (peak and SH images compatible with MRtrix)
 
−
* Tractograms: fib/vtk, tck and trk.
 
−
 
 
−
'''Image preprocessing'''
 
−
* Registration
 
−
* Head-motion correction
 
−
* Denoising
 
−
* Skull stripping and brain mask segmentation
 
−
* Resampling, cropping, flipping and merging
 
−
* Header modifications
 
−
* Single volume extraction
 
−
 
 
−
'''Diffusion gradient/b-value processing'''
 
−
* b-value rounding
 
−
* Gradient direction flipping
 
−
* Gradient direction subsampling
 
−
* Averaging of gradient directions/volumes
 
−
* Gradient direction and b-value visualization
 
−
 
 
−
'''ODF reconstruction and signal modelling'''
 
−
* Tensor and Q-ball reconstruction
 
−
* Other reconstructions via Dipy wrapping (CSD, 3D SHORE, SFM)
 
−
* ODF peak calculation
 
−
* MRtrix or camino results can be imported
 
−
 
 
−
'''Quantification of diffusion-weighted/tensor/ODF images'''
 
−
* Intravoxel Incoherent Motion (IVIM) and diffusion kurtosis analysis
 
−
* Calculation many other derived indices such as ADC, MD, GFA, FA, RA, AD, RD
 
−
* Image statistics
 
−
 
 
−
'''Segmentation'''
 
−
* Automatic white matter bundle segmentation (TractSeg) [3]
 
−
* Automatic brain mask segmentation
 
−
* Manual image segmentation and operations on segmentations
 
−
* SOON: automatic brain tissue segmentation
 
−
 
 
−
'''Fiber tractography'''
 
−
* Global tractography [4]
 
−
* Streamline tractography
 
−
** Interactive (similar to [5]) or seed image based
 
−
** Deterministic or probabilistic
 
−
** Peak, ODF, tensor and raw dMRI based. The latter one in conjunction with machine learning based tractography [6]
 
−
** Various possibilities for anatomical constraints.
 
−
** Tractography priors in form of additional peak images, e.g. obtained using TractSeg
 
−
 
 
−
'''Fiber processing'''
 
−
* Tract dissection (parcellation or ROI based)
 
−
* Tract filtering by
 
−
** length
 
−
** curvature
 
−
** direction
 
−
** weight
 
−
** density
 
−
* Tract resampling and compression
 
−
* Tract transformation
 
−
** Mirroring
 
−
** Rotating and translating
 
−
** Registration (apply transform of previously performed image registration)
 
−
* Tract coloring
 
−
** Curvature
 
−
** Length
 
−
** Weight
 
−
** Scalar map (e.g. FA)
 
−
* Other operations
 
−
** Join
 
−
** Subtract
 
−
** Copy
 
−
* Fiber clustering [7]
 
−
* Fiber fitting and weighting similar to SIFT2 and LiFE [8,9]
 
−
* Principal direction extraction (fibers --> peaks)
 
−
* Tract derived images:
 
−
** Tract density images
 
−
** Tract endpoint images
 
−
** Tract envelopes
 
−
 
 
−
'''Fiberfox dMRI simulations''' [10]
 
−
* Multi-compartment signal modeling
 
−
* Simulation of the k-space acquisition including
 
−
** Compartment specific relaxation effects
 
−
** Artifacts such as noise, spikes, ghosts, aliasing, distortions, signal drift, head motion, eddy currents and Gibbs ringing
 
−
** Definition of important acquisition parameters such as bvalues and gradient directions, TE, TR, dwell time, partial Fourier, ...
 
−
* Manual definition of fiber configurations, e.g. for evaluation purposes
 
−
 
 
−
'''Other features'''
 
−
* Brain network statistics and visualization (connectomics)
 
−
* Interactive Python console
 
−
* Integrated screenshot maker
 
−
* Command line tools for most functionalities
 
−
 
 
−
 
 
−
Since the last release 2017.07 there have been a lot of feature additions, bug fixes and optimizations.
 
−
 
 
−
 
 
−
== Downloads ==
 
−
 
 
−
If you encounter any bugs, please report them in our [https://phabricator.mitk.org/maniphest/task/edit/form/21/ bugtracking] system or use the [http://mitk.org/wiki/MITK_Mailinglist MITK-users mailing list]. We are grateful for any feedback!
 
−
 
 
−
 
 
−
=== Latest stable installers (2017.07) ===
 
−
Commit hash 2bda849ee86a362583ee3d2beb4baaca038bd8a5
 
−
{| class="wikitable" width=100% style="background-color:#ffffff;"
 
−
| Windows 7, Windows 10
 
−
| [http://mitk.org/download/releases/MITK-Diffusion-2017.07/Windows/MITK-Diffusion-2017.07-win64.exe MS Windows (64 bit) installer]
 
−
|-
 
−
| Windows 7, Windows 10
 
−
| [http://mitk.org/download/releases/MITK-Diffusion-2017.07/Windows/MITK-Diffusion-2017.07-win64.zip MS Windows (64 bit) zip archive]
 
−
|-
 
−
| Ubuntu 16.04
 
−
|  [http://mitk.org/download/releases/MITK-Diffusion-2017.07/Linux/MITK-Diffusion-2017.07-linux64.tar.gz Ubuntu (64 bit), tar.gz archive]
 
−
|-
 
−
| Ubuntu 14.04
 
−
|  [http://mitk.org/download/releases/MITK-Diffusion-2017.07/Linux/MITK-Diffusion-2017.07-Ubuntu14.04.64bit.tar.gz Ubuntu (64 bit), tar.gz archive]
 
−
|}
 
−
 
 
−
'''Known issues fixed in the current master:'''
 
−
The Fiberfox command line application does not read the b-value but uses a default b-value of 1000 s/mm². This bug does not affect the GUI version of Fiberfox. This bug also has no effect if the first non-zero b-value is 1000 s/mm², which is for example the case in the simulated HCP dataset (10.5281/zenodo.572345).
 
−
This bug is fixed in the current master of the MITK source code.
 
−
 
 
−
 
 
−
=== Requirements ===
 
−
 
 
−
* '''For Ubuntu users''':
 
−
** Install Python 3.X: <pre>sudo apt install python3 python3-pip</pre>
 
−
** Download Python requirements file: https://phabricator.mitk.org/file/data/r7yikza26ozkodxlypsq/PHID-FILE-thn2yotzr2jein4apf3x/PythonRequirements.txt
 
−
** Install Python requirements: <pre>pip3 install -r PythonRequirements.txt</pre>
 
−
** If your are behind a proxy use <pre>pip3 --proxy <proxy> install -r PythonRequirements.txt</pre>
 
−
 
 
−
* '''For Windows users''':
 
−
** MITK Diffusion requires the Microsoft Visual C++ 2017 Redistributable to be installed on the system. The MITK Diffusion installer automatically installs this redistributable for you if not already present on the system, but it needs administrative privileges to do so. So to install the redistributable, '''''run the MITK Diffusion installer as administrator'''''.
 
−
** Install Python 3.X: https://www.anaconda.com/download/
 
−
** Download Python requirements https://phabricator.mitk.org/file/data/r7yikza26ozkodxlypsq/PHID-FILE-thn2yotzr2jein4apf3x/PythonRequirements.txt
 
−
** Install Python requirementsfrom the conda command prompt: <pre>pip install -r PythonRequirements.txt</pre>
 
−
** If your are behind a proxy use <pre>pip --proxy <proxy> install -r PythonRequirements.txt</pre>
 
−
 
 
−
* '''Requirements for all deep-learning based functionalities''':
 
−
** Affected functionalities:
 
−
*** Brain extraction
 
−
*** TractSeg
 
−
** Pytorch: https://pytorch.org/
 
−
** CUDA: https://developer.nvidia.com/cuda-downloads
 
−
** (optional) cuDNN: https://developer.nvidia.com/cudnn
 
−
 
 
−
 
 
−
== Building MITK Diffusion from source ==
 
−
# Install [https://www.qt.io/ Qt] on your system (>= 5.11.1).
 
−
# Clone MITK from out [https://phabricator.mitk.org/source/mitk.git git repository] using [https://git-scm.com/ Git version control].
 
−
# Configure the MITK Superbuild using [https://cmake.org/ CMake] (>= 3.10).
 
−
## Choose the source code directory and an empty binary directory.
 
−
## Click "Configure".
 
−
## Set the option MITK_BUILD_CONFIGURATION to "DiffusionRelease".
 
−
## Click "Generate".
 
−
# Build the project
 
−
## Linux: Open a console window, navigate to the build folder and type "make -j8" (optionally supply the number threads to be used for a parallel build qith -j).
 
−
## Windows (requires visual studio): Open the MITK Superbuild solution file and build all projects.
 
−
# The build may take some time and should yield the binaries in "your_build_folder/MITK-build/bin"
 
−
 
 
−
More detailed build instructions can be found in the [http://docs.mitk.org/nightly/BuildInstructionsPage.html documentation.]
 
−
 
 
−
 
 
−
== References ==
 
−
 
 
−
[1] Fritzsche, Klaus H., Peter F. Neher, Ignaz Reicht, Thomas van Bruggen, Caspar Goch, Marco Reisert, Marco Nolden, et al. “MITK Diffusion Imaging.” Methods of Information in Medicine 51, no. 5 (2012): 441.
 
−
 
 
−
[2] Fritzsche, K., and H.-P. Meinzer. “MITK-DI A New Diffusion Imaging Component for MITK.” In Bildverarbeitung Für Die Medizin, n.d.
 
−
 
 
−
[3] Wasserthal, Jakob, Peter Neher, and Klaus H. Maier-Hein. “TractSeg - Fast and Accurate White Matter Tract Segmentation.” NeuroImage 183 (August 4, 2018): 239–53.
 
−
 
 
−
[4] Neher, P. F., B. Stieltjes, M. Reisert, I. Reicht, H.P. Meinzer, and K. Maier-Hein. “MITK Global Tractography.” In SPIE Medical Imaging: Image Processing, 2012.
 
−
 
 
−
[5] Chamberland, M., K. Whittingstall, D. Fortin, D. Mathieu, und M. Descoteaux. „Real-time multi-peak tractography for instantaneous connectivity display“. Front Neuroinform 8 (2014): 59. doi:10.3389/fninf.2014.00059.
 
−
 
 
−
[6] Neher, Peter F., Marc-Alexandre Côté, Jean-Christophe Houde, Maxime Descoteaux, and Klaus H. Maier-Hein. “Fiber Tractography Using Machine Learning.” NeuroImage. Accessed July 17, 2017. doi:10.1016/j.neuroimage.2017.07.028.
 
−
 
 
−
[7] Garyfallidis, Eleftherios, Matthew Brett, Marta Morgado Correia, Guy B. Williams, and Ian Nimmo-Smith. “QuickBundles, a Method for Tractography Simplification.” Frontiers in Neuroscience 6 (2012).
 
−
 
 
−
[8] Smith, Robert E., Jacques-Donald Tournier, Fernando Calamante, and Alan Connelly. “SIFT2: Enabling Dense Quantitative Assessment of Brain White Matter Connectivity Using Streamlines Tractography.” NeuroImage 119, no. Supplement C (October 1, 2015): 338–51.
 
−
 
 
−
[9] Pestilli, Franco, Jason D. Yeatman, Ariel Rokem, Kendrick N. Kay, and Brian A. Wandell. “Evaluation and Statistical Inference for Human Connectomes.” Nature Methods 11, no. 10 (October 2014): 1058–63.
 
−
 
 
−
[10] Neher, Peter F., Frederik B. Laun, Bram Stieltjes, and Klaus H. Maier-Hein. “Fiberfox: Facilitating the Creation of Realistic White Matter Software Phantoms.” Magnetic Resonance in Medicine 72, no. 5 (November 2014): 1460–70. doi:10.1002/mrm.25045.
 
−
 
 
−
 
 
−
== Contact ==
 
−
If you have questions about the application or if you would like to give us feedback, don't hesitate to contact us using [http://mitk.org/wiki/MITK_Mailinglist our mailing list] or, for questions that are of no interest for the community, [https://www.dkfz.de/en/mic/team/people/Peter_Neher.html directly].
 

Revision as of 12:33, 24 August 2018

  1. REDIRECT "MitkDiffusion"
Retrieved from "http://mitk.org/w/index.php?title=DiffusionImaging&oldid=3374"