filip-szczepankiewicz / diff_enc_sim

Illustrative simulation and animation of spin phase dispersion caused by diffusion encoding created for the ISMRM 2019 educational lectures.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Diffusion Encoding Simulation (diff_enc_sim)

Filip Szczepankiewicz (filip.szczepankiewicz@med.lu.se)

Brigham and Women's Hospital, Boston, MA, USA
Harvard Medical School, Boston, Ma, USA
Lund University, Lund, Sweden

Scope

This code provides a simple framework for visualizing and animating the effect of diffusion encoding on spin along a single direction in space. This set of functions can be used to visualize the phase over time for arbitrary field gradients for diffusing particles where the movement can be arbitrarily defined (e.g. based on a gaussian propagator). An assortment of .gif animations is available in the /animations/ folder.

To get started, execute the example code, e.g. des_example_1 which should render the animation below.

Since the ISMRM 2022, the code also includes animations that show the effects of varying the echo time, repetition time and inversion time. Moreover, there are animations that show the confounding effects caused by concomitant gradients and cross-terms with background gradients.

Among other improvements, there is now code that creates gifs from images in a folder or cell structure. See the function des_imgl2gif. For best results, start from images in a folder, where the images are saved at a high resolution. You can do this by using custom image write scripts. For example fix_save_figure from this GitHub repo.

Origin

The code was prepared for the ISMRM 2019 diffusion MRI Educational session: Diffusion & Microstructure: Fundamentals & Frontiers for the lecture Diffusion MRI Acquisition, Part I: From Propagator to Image (login is required to access the lecture video).

The repository was slightly extended in preparation for the ISMRM 2022 diffusion MRI Educational session: Diffusion: From Basic to Advanced, for the lecture Encoding Diffusion: Advanced gradient design and relaxation-weighting.

Lecture materials

You can download the lecture slides in pdf-format here: Encoding Diffusion: Advanced gradient design and relaxation-weighting (ISMRM 2022).

Example animation

Example animation

About

Illustrative simulation and animation of spin phase dispersion caused by diffusion encoding created for the ISMRM 2019 educational lectures.

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:MATLAB 100.0%