Skip to content

imr-framework/mrf

Repository files navigation

Open Source Magnetic Resonance Fingerprinting Package (OMEGA)


Open Source MRF is a Matlab based software package which enables vendor neutral, fast prototyping of magnetic resonance fingerprinting using Pulseq. It is supported by open-soure standards.

Magnetic resonance fingerprinting is a framework that allows for simultaneous quantification of tissue properties and hence is a significant tool to understand multi-vendor multi-site variability. However, a vendor-neutral, open soure implementation of MRF has not been developed to the best of our knowlegde. In this work, we develop the package to enable comparisons between two sites with two vendors.

Open Source MRF consists of five modules. Sequence design, image reconstruction, dictionary simulation, dictionary matching, and ROI analysis.

Please note: You need to install Pulseq and Michigan Image Reconstruction Toolbox (MIRT) in your system for the package to run. Visit Pulseq and MIRT for more information.

This package contains five different parts. To use the package, please pull the complete mrf repository.

How to use the package

Generate MRF Sequence

  1. Call Spiral_Design/Function/gen_MRF_sequence_pulseq.m. The function returns parameters of the sequence that are used in other parts of the package
  2. A MRF sequence based on Jiang's paper [1] is implemented using Pulseq framework.
  3. The user should be able play the generated .seq file on a scanner with Pulseq interpreter installed. This sequence has been verified on a scanner by the author.

Image Reconstruction

  1. Call Image_Reconstruction/Function/MRF_recon.m
  2. The script lets user select raw data file (.dat) from scanner and trajectory file (.mat) and reconstruct the image using sliding window method and complex channel combination [2].

EPG Dictionary Simulation

  1. Call EPG_dict_sim/Function/gen_MRF_dict.m.
  2. A dictionary is simulated based on the T1/T2 ranges using Extend Phase Graph(EPG) [3] method.

Dictionary Matching

  1. Call Dictionary_Matching/Function/MRF_Dic_Matching.m.
  2. The script uses vector dot product to find the best matching dictionary entry and retrieves all parameters for that entry.

ROI Analysis Tool

  1. Call ROI_analysis_tool/Function/NIST_ROI_ana.m .
  2. The function takes in the parameter maps of ISMRM/NIST phantom and return locations of spheres in correct orders.

Demo

To test the package, a demo script can be found at mrf/demo_MRF.m. This script generates a sequence, then read a sample data, reconstruct the data. A dictionary is generated and dictionary matching is performed. Then ROI analysis is done to provide T1 and T2 values for each spheres.

In addition to the overall demo script, each module can be tested by itself. The demo script can be located under each module, which will help verify the correctness of the module.

Reference

[1] Jiang Y, Ma D, Seiberlich N, Gulani V, Griswold M. MR fingerprinting using fast imaging with steady state precession (FISP) with spiral readout. Magn Reson Med. 2015;74(6):spcone-spcone. doi:10.1002/mrm.26048

[2] Roemer P, Edelstein W, Hayes C, Souza S, Mueller O. The NMR phased array. Magn Reson Med. 1990;16(2):192-225. doi:10.1002/mrm.1910160203

[3] Weigel M. Extended phase graphs: Dephasing, RF pulses, and echoes - pure and simple. Journal of Magnetic Resonance Imaging. 2014;41(2):266-295. doi:10.1002/jmri.24619

About

An end to end, vendor neutral MRF package

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages