TF2.4_IVIM_code_collection

The ISMRM Open Science Initiative for Perfusion Imaging (OSIPI) is an initiative of the ISMRM Perfusion Study Group, founded in 2019 after a membership survey, and with a mission to:

“promote the sharing of perfusion imaging software in order to eliminate the practice of duplicate development, improve the reproducibility of perfusion imaging research, and speed up the translation into tools for discovery science, drug development, and clinical practice”

This IVIM code collection code library is maintained by OSIPI Taskforce 2.4 and aims to collect, test and share open-source code related to intravoxel incoherent motion (IVIM) analysis of diffusion encoded MRI data to be used in research and software development. Code contributions can include any code related IVIM analysis (denoising, motion correction, model fitting, etc.), but at an initial phase, development of tests and other features of the repository will predominantly focus on fitting algorithms. A goal of the IVIM OSIPI task force is to develop a fully tested and harmonized code library, building upon the contributions obtained through this initiative. Documentation and analysis are available on the OSIPI TF2.4.

We have some useful tools and further documentation on https://osipi.github.io/TF2.4_IVIM-MRI_CodeCollection/.

How to contribute

If you would like to get involve in OSIPI and work within the task force, please email the contacts listed on our website.

If you would like to contribute with code, please follow the instructions below:

• Setting up Git
• How to create a copy of the respository and contribute changes to the repository
• Guidelines for IVIM code contribution
• Guidelines to creating a test file

If you would like to use code from the repository and/or are new to Github or IVIM, please see the jupyter notebook below:

• Introduction to TF2.4_IVIM-MRI_CodeCollection github and IVIM Analysis using Python

If you would like to use MATLAB-based algorithms or apply the testing framework to one of these algorithms, please have a look at these instructions:

• MATLAB-related instructions

Repository Organization

The repository is organized in four main folders along with configuration files for automated testing.

The doc folder contains all documentation related to the repository of task force 2.4.

The src folder contains source code contributed by the the community. Within src, the original folder contains the code to be tested, and the wrappers folder contains code for harmizing the calls the different code contributions. Within the original folders, contributions are stored in Initials_Institution, e.g. src/original/OGC_AmsterdamUMC.

The test folder contains the test files corresponding to the contributed code in src. to be structured

The utils folder contains various helpful tools.

Citing

If this repository was useful, please cite our upcoming MRM paper. The repository contains a lot of code from other sites. Please cite the appropriate papers depending on the code you used. The citations can be found with the "cite" function from OsipiBase:

fit=osipibase(algorithm="IAR_LU_biexp")
fit.cite()

DOIs can also be found in code_contributions_record.

View Testing Reports