Metadata-Version: 1.2
Name: mdt
Version: 0.14.2
Summary: Microstructure Diffusion Toolbox
Home-page: https://github.com/cbclab/MDT
Author: Robbert Harms
Author-email: robbert.harms@maastrichtuniversity.nl
Maintainer: Robbert Harms
Maintainer-email: robbert.harms@maastrichtuniversity.nl
License: LGPL v3
Description: ################################
        Microstructure Diffusion Toolbox
        ################################
        The Microstructure Diffusion Toolbox, MDT, (formerly known as the Maastricht Diffusion Toolbox) is a framework and library for parallelized (GPU and multi-core CPU) diffusion Magnetic Resonance Imaging (MRI) modeling.
        MDT's object oriented and modular design allows arbitrary user specification and combination of biophysical MRI compartment models, diffusion- and T1, T2, T2* based microstructure models,
        likelihood functions and optimization algorithms.
        MDT was designed with compatibility in mind and adheres to input, output and variable naming conventions used by other related software tools.
        Many diffusion and relaxometry microstructure models are included, and new models can be added simply by adding Python script files.
        MDT can be extended to other modalities and other parametric models estimated from data volumes varying along controlled parameters (such as b-values, diffusion times, TE, TM, flip angle, etc).
        The parallelized accelerated computations allow for tens to hundred times faster model fitting, even on standard GPU (and/or CPU) hardware, making MDT ideal for large group studies or population studies.
        
        
        *******
        Summary
        *******
        * HCP pipelines
        * Comes with ActiveAx, CHARMED, NODDI, Ball&Sticks, Kurtosis and Tensor models.
        * GUI, command line and python interface
        * Easy modeling language
        * Free Open Source Software: LGPL v3 license
        * Python and OpenCL based
        * Tags: diffusion, dMRI, MRI, optimization, parallel, opencl, python
        
        
        *****
        Links
        *****
        * Full documentation: http://mdt_toolbox.readthedocs.io
        * Project home: https://github.com/cbclab/MDT
        
        
        ************
        HCP Pipeline
        ************
        MDT comes pre-installed with Human Connectome Project (HCP) compatible pipelines for the MGH and the WuMinn 3T studies.
        To run, after installing MDT, go to the folder where you downloaded your (pre-processed) HCP data (MGH or WuMinn) and execute:
        
        .. code-block:: console
        
            $ mdt-batch-fit . 'NODDI (Cascade)'
        
        and it will autodetect the study in use and fit your selected model to all the subjects.
        
        
        ************************
        Quick installation guide
        ************************
        The basic requirements for MDT are:
        
        * Python 3.x
        * OpenCL 1.2 (or higher) support in GPU driver or CPU runtime
        
        
        **Linux**
        
        For Ubuntu >= 16 you can use:
        
        * ``sudo add-apt-repository ppa:robbert-harms/cbclab``
        * ``sudo apt-get update``
        * ``sudo apt-get install python3-mdt python3-pip``
        * ``sudo pip3 install tatsu``
        
        For Debian users and Ubuntu < 16 users, install MDT with:
        
        * ``sudo apt-get install python3 python3-pip python3-pyopencl python3-numpy python3-nibabel python3-pyqt5 python3-matplotlib python3-yaml python3-argcomplete libpng-dev libfreetype6-dev libxft-dev``
        * ``sudo pip3 install mdt``
        
        Note that ``python3-nibabel`` may need NeuroDebian to be available on your machine. An alternative is to use ``pip3 install nibabel`` instead.
        
        Users of `Singularity <http://singularity.lbl.gov/>`_ can use the recipe at https://github.com/akhanf/mdt-singularity , kindly made available by an user of MDT.
        
        
        **Windows**
        
        The installation on Windows is a little bit more complex and the following is only a quick reference guide.
        For complete instructions please view the `complete documentation <https://mdt_toolbox.readthedocs.org>`_.
        
        * Install Anaconda Python 3.*
        * Install MOT using the guide at https://mot.readthedocs.io
        * Open an Anaconda shell and type: ``pip install mdt``
        
        
        **Mac**
        
        * Install Anaconda Python 3.*
        * Open a terminal and type: ``pip install mdt``
        
        Please note that Mac support is experimental due to the unstable nature of the OpenCL drivers in Mac, that is, users running MDT with the GPU as selected device may experience crashes.
        Running MDT in the CPU seems to work though.
        
        
        For more information and full installation instructions see https://mdt_toolbox.readthedocs.org
        
Keywords: mdt,diffusion MRI,model recovery,imaging analysis
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Development Status :: 5 - Production/Stable
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering
