Largely obsolete IDL version of the Bloch Simulator for teaching MRI


 

This page describes the installation of the largely obsolete IDL implementation of the Bloch Simulator which is free, educational MRI sofware for Windows, Mac and Linux. Since its development, a version that runs directly in a browser has been released. Click here to proceed to this recommended version . However, there may still be reasons to install the IDL version: Most notably, it is faster than the web-version and it provides a way to save animations.

The original IDL version of the software was described in RadioGraphics (Reviewer1: "Very nicely done...". Reviewer2: "...help greatly during classroom presentations of MRI basics and applications..."). With an add-on viewer, the capabilities of modern graphics cards was exploited to futher improve the interactive, real-time visualization of magnetic resonance techniques as illustrated to the right and on the viewer homepage.  At the bottom of this page, you will find a download version and example movies recorded using the program. Answers to frequently asked questions are in the FAQ

Above: Screen dump illustrating the use of the program. Click image one or more times to enlarge. Initial conditions are chosen via menues as shown. Subsequently radio-frequency (RF) pulses can be employed to illustrate MR techniques and sequences. The screen shot is captured during a demonstration of excitation in the presence of field inhomogeneities. The spin isochromates shown in white are pushed by the RF field as indicated by the red bars.

Example animations with soundtracks published in RadioGraphics

These animations with soundtracks show examples of interactive use of the simulator for teaching. Please note that the recommended version provides significantly better graphics.

Additional movies (no soundtrack)

The following additional simulations made with the add-on OpenGL viewer are representative of the programs capability to illustrate more complicated matters. They were recorded by choosing appropriate initial conditions and pulse sequence elements (RF pulses, spoilers,...) via the graphical user interface.

  • Stimulated echo. A more complicated sequence is shown in this movie, where the x-axis is used to indicate the position along the direction of a field gradient. Hence, a row of spin isochomates precessing at different frequencies are shown. After a 90 degree excitation pulse, a phase roll accumulates due to the variation in Larmor precession frequency. The wavelength of the phase roll decreases until a second 90 degree pulse is employed. This rotates the disc of spins and the transversal component of the magnetization dephases. After spoiling (i.e. projection of the magnetization on to the z-axis) it becomes clear that the residual longitudinal magnetization forms a sinusoidal pattern. A third 90 degree RF pulse rotates this sinusoidal pattern into the transversal plane. It is partially refocused by the gradient after a waiting period equal to the first dephasing period.
  • Spin ensemble. The net magnetization (shown in green) is made up from many small contributions pointing in different directions. This is a result of the imperfect alignment caused by the relatively weak fields used for MRI (the field is strong compared to the earth field, for example, but the thermal energies by far exceeds the energy differences associated with nuclear orientation). The near isotropic spin-distribution is rotated as a fixed structure by RF. Hence it is sufficient to consider only the dynamics of the net magnetization for regions where the field variations are insignificant.
    Note
    : The spins are not only pointing up or down, as often said. This and other MRI myths are discussed here.

Download of the largely obsolete IDL-implementation of the Bloch Simulator

The program described above is available for download as an IDL "save" file at http://www.drcmr.dk/Bloch/bloch.sav . It does not require a full IDL licence, but can be run from a IDL virtual machine, that can be downloaded from the ITT homepage free of charge (or from here: Mac, Windows, Linux (version 6.3. Later is needed for Vista)).

Install guide for running bloch.sav in an IDL Virtual Machine:

  • First consider if you really want to install the largely obsolete IDL version instead of the recommended browser-based version. If so, proceed.
  • Download IDL VM  either from here ( Mac, Windows, Linux) or by following steps 1-4 below:
  1. Go to the ITT homepage
  2. Select Products in the top menu and choose IDL VM (virtual machine).
  3. Click on download IDL VM (you need to register to download the program from the ITT homepage).
  4. Select the appropriate version for your computer. 
  • Install IDL VM. It takes up approximately 200 MB of space depending on version. Default install options are appropriate. Mac users: Avoid spaces in install path.
  • Download bloch.sav
  • Run the file with IDL VM:
    • Windows: Double click the bloch.sav file and click anywhere on the IDL startup window to get past it.
    • Linux: Do the same or type "idl -vm=bloch.sav" to start the program.
    • Mac: Do the same or click "bloch.sav" to associate it with the application "idlvm.app" in the IDL install directory.
  • Now test the simulator. If you like it, you should definitely consider downloading the free Bloch viewer that greatly improves the clarity by exploiting the capabilities of modern 3D graphics cards. 
  • In case of problems, please consult the trouble-shooting guide that covers both the simulator and the viewer.

Contact Lars, if you have comments or questions (address: larsh @ drcmr.dk).