dmipy
The open source toolbox for reproducible diffusion MRI-based microstructure estimation
Science Score: 57.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 2 DOI reference(s) in README -
○Academic publication links
-
✓Committers with academic emails
4 of 11 committers (36.4%) from academic institutions -
✓Institutional organization owner
Organization athenaepi has institutional domain (team.inria.fr) -
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (14.9%) to scientific vocabulary
Keywords
Repository
The open source toolbox for reproducible diffusion MRI-based microstructure estimation
Basic Info
Statistics
- Stars: 107
- Watchers: 21
- Forks: 36
- Open Issues: 60
- Releases: 3
Topics
Metadata Files
README.md
Dmipy: Diffusion Microstructure Imaging in Python
The Dmipy software package facilitates the reproducible estimation of diffusion MRI-based microstructure features. It does this by taking a completely modular approach to Microstructure Imaging. Using Dmipy you can design, fit, and recover the parameters of any multi-compartment microstructure model in usually less than 10 lines of code. Created models can be used to simulate and fit data for any PGSE-based dMRI acquisition, including single shell, multi-shell, multi-diffusion time and multi-TE acquisition schemes. Dmipy's main features include:
Complete Freedom in Model Design and Optimization - Any combination of tissue models (e.g. Gaussian, Cylinder, Sphere) and axon bundle representation (e.g. orientation-dispersed/diameter-distributed) can be combined into a multi-compartment model. - Any appropriate model can be orientation-dispersed and/or axon diameter-distributed. - Any predefined or custom parameter constraints or relations can be imposed. - Free choice of global optimizer to fit your model to the data (Brute-Force or Stochastic). - Fit the spherical mean of any multi-compartment model to the spherical mean of the data. - Generalized multi-compartment constrained spherical deconvolution.
Human Connectome Project Data Interface Dmipy enables you to directly download any HCP subject data using your own credentials.
Numba-Accelerated, Multi-Core processing Dmipy takes heavy advantage of Python's pathos multi-core processing and numba function compilation.
Documentation on Tissue and Microstructure Models We include documentation and illustrations of all tissue models and parameter distributions, as well as example implementations and results on HCP data for Ball and Stick, Ball and Racket, NODDI-Watson/Bingham, AxCaliber, Spherical Mean models and more.
Dipy Compatibility Dmipy is designed to be complementary for Dipy users. Dipy gradient tables can be directly used in Dmipy models, Dipy models can be used to give initial parameter guesses for Dmipy optimization, and Dmipy models that estimate Fiber Orientation Distributions (FODs) can be visualized and used for tractography in Dipy.
Dmipy allows the user to do Microstructure Imaging research at the highest level, while the package automatically takes care of all the coding architecture that is needed to fit a designed model to a data set. The Dmipy documentation can be found at http://dmipy.readthedocs.io/. If you use Dmipy for your research publications, we kindly request you cite this package at the reference at the bottom of this page.
Installation
You can install dmipy using pypi by typing in your terminal - python3 -m pip install dmipy
or you can manually - clone repository - python setup.py install
See solutions to common issues
Dependencies
Recommended to use Anaconda Python distribution. - numpy >= 1.13 - scipy - dipy - cvxpy - boto (optional for HCP-AWS interface) - pathos (optional for multi-core processing) - numba (optional for faster functions)
Getting Started
To get a feeling for how to use Dmipy, we provide a few tutorial notebooks: - Setting up an acquisition scheme - Simulating and fitting data using a simple Stick model - Combining biophysical models into a Microstructure model - Creating a dispersed and/or distributed axon bundle representation - Imposing parameter links and constraints - Parameter Cascading: Using a simple model to initialize a complex one - Generalized Multi-Tissue Modeling
Explanations and Illustrations of Dmipy Contents
Biophysical Models and Distributions
- Cylinder Models (Axons, e.g. [Assaf et al. 2004])
- Sphere Models (Tumor cells, e.g. [Panagiotaki et al. 2014])
- Parameter Distribution Models (Axon Diameter Distribution, e.g. [Assaf et al. 2008])
- Gaussian Models (Extra-axonal, e.g. [Behrens et al. 2003])
- Tissue Response Function Models and Estimation (WM/GM/CSF, e.g. [Jeurissen et al. 2014])
- Spherical Distribution Models (Axon Dispersion, e.g. [Kaden et al. 2007])
- Spherical Mean of any Compartment Model ### Global Multi-Compartment Optimizers
- Brute Force to Gradient Descent (Brute2Fine)
- Stochastic (MIX) [Farooq et al. 2016] ### Constrained Spherical Deconvolution Optimizers
- Generalized Multi-Shell Multi-Compartment CSD [Tournier et al. 2007, Jeurissen et al. 2014] ## Dmipy implementations of Microstructure Models in Literature Dmipy uses HCP data to illustrate microstructure model examples. To reproduce these examples, dmipy provides a direct way to download HCP data (using your own AWS credentials) in the HCP tutorial. ### Single Bundle Models
- Ball and Stick [Behrens et al. 2003]
- Ball and Racket [Sotiropoulos et al. 2012]
- NODDI-Watson [Zhang et al. 2012]
- NODDI-Bingham [Tariq et al. 2016]
- Multi-Tissue NODDI [Frigo et al. 2020]
- SMT-NODDI [Cabeen et al. 2019]
- AxCaliber [Assaf et al. 2008]
- AxCaliber with Extra-Axonal Diffusion Time-Dependence [De Santis et al. 2016]
Crossing Bundle Models
Tumor Models
- IVIM [Le Bihan et al. 1988, Gurney-Champion et al. 2018]
- VERDICT [Panagiotaki et al. 2014] ### Spherical Mean-Based Models Any Spherical Mean model can also estimate parametric FODs.
- Spherical Mean Technique [Kaden et al. 2015]
- Multi-Compartment Microscopic Diffusion Imaging [Kaden et al. 2016] ### Spherical Deconvolution-Based Models Constrained spherical deconvolution (CSD) models are primarily used for Fiber Orientation Distribution (FOD) estimation. Multi-Tissue CSD models improve FOD estimation by separating WM/GM/CSF signal contributions using multiple tissue response functions.
- Multi-Shell Multi-Compartment CSD [model-based version of Jeurissen et al. 2014]
- Multi-Shell Multi-Tissue CSD with Unsupervised 3-Tissue Response Function Estimation [Jeurissen 2014, Dhollander 2016a]
- Single-Shell (1 shell + b0) Multi-Tissue CSD [Dhollander et al. 2016b]
How to contribute to Dmipy
Dmipy's design is completely modular and can easily be extended with new models, distributions or optimizers. To contribute, view our contribution guidelines.
How to cite Dmipy
- Primary Reference: Rutger Fick, Demian Wassermann and Rachid Deriche, "The Dmipy Toolbox: Diffusion MRI Multi-Compartment Modeling and Microstructure Recovery Made Easy", Frontiers in Neuroinformatics 13 (2019): 64.
- Github Repository: Rutger Fick, Rachid Deriche, & Demian Wassermann. (2019, October 15). The Dmipy Toolbox: Diffusion MRI Multi-Compartment Modeling and Microstructure Recovery Made Easy (Version 1.0). Zenodo. http://doi.org/10.5281/zenodo.3490325
Owner
- Name: Athena Project Team @ INRIA Sophia Antipolis-Méditerranée
- Login: AthenaEPI
- Kind: organization
- Location: Sophia Antipolis, France
- Website: https://team.inria.fr/athena/
- Repositories: 1
- Profile: https://github.com/AthenaEPI
GitHub Events
Total
- Watch event: 12
- Push event: 1
- Pull request event: 2
Last Year
- Watch event: 12
- Push event: 1
- Pull request event: 2
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Rutger Fick | r****k@i****r | 566 |
| Rutger Fick | f****r@g****m | 212 |
| Demian Wassermann | d****n@i****r | 50 |
| olushO | a****i@i****r | 9 |
| Rutger Fick | r****8@g****m | 9 |
| Matteo Frigo | m****o | 8 |
| Demian Wassermann | d****w | 5 |
| Sara Sedlar | s****r@g****m | 2 |
| Leon Weninger | 1****n | 2 |
| Tom | t****m@d****k | 1 |
| dannis999 | 3****9 | 1 |
Issues and Pull Requests
Last synced: 8 months ago
All Time
- Total issues: 56
- Total pull requests: 50
- Average time to close issues: 3 months
- Average time to close pull requests: 30 days
- Total issue authors: 19
- Total pull request authors: 10
- Average comments per issue: 1.75
- Average comments per pull request: 1.78
- Merged pull requests: 35
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 2
- Average time to close issues: N/A
- Average time to close pull requests: 2 days
- Issue authors: 2
- Pull request authors: 2
- Average comments per issue: 1.5
- Average comments per pull request: 0.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- rutgerfick (20)
- matteofrigo (9)
- foxet (7)
- villalonreina (5)
- StefaniaOliviero (1)
- thijsdhollander (1)
- egolkar (1)
- engineeringmath (1)
- cxmDREAM (1)
- willi3by (1)
- chenshuomr (1)
- fayemckenna (1)
- sitek (1)
- TMNir (1)
- irenepersoglia (1)
Pull Request Authors
- rutgerfick (30)
- matteofrigo (11)
- RamiBouk (2)
- weningerleon (2)
- Sara04 (2)
- tomdelahaije (1)
- maurozucchelli (1)
- dannis999 (1)
- mjallais (1)
- demianw (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 54 last-month
- Total dependent packages: 0
- Total dependent repositories: 3
- Total versions: 4
- Total maintainers: 2
pypi.org: dmipy
dmipy: diffusion microstructure imaging in python
- Homepage: https://github.com/AthenaEPI/dmipy
- Documentation: https://dmipy.readthedocs.io/
- License: MIT
-
Latest release: 1.0.5
published about 5 years ago
Rankings
Maintainers (2)
Dependencies
- boto *
- cvxpy *
- dipy *
- numpy *
- pathlib *
- scipy *