Vector Array (Spins Panel)

The Spins panel visualizes the magnetization of a three-dimensional lattice of spins during MRI pulse sequences.

Each spin represents a group of protons treated as one magnetic dipole, drawn as an arrow through a sphere. The matrix is simulated with the Bloch equations, including T1 and T2 relaxation and off-resonance.

Use the expand button (↗, top right) to view the spins full screen with additional controls.

Navigation

  • Drag to orbit the camera around the matrix.
  • Pinch to zoom in and out.
  • View buttons (left side) snap to Oblique, Axial, Sagittal and Coronal views. Optional zoom and rotate animations can be enabled in Settings.
  • Expand / collapse (top right) toggles the full-screen spins view.
Expanded Spins view during selective excitation
Selective excitation, expanded Spins view

Coordinate system

AxisColorDirection
XYellowLeft–right
YCyanAnterior–posterior
ZBlueSuperior–inferior, along the main field B0

The largest matrix dimension spans the full 25 cm field of view; smaller dimensions keep the same spin spacing.

Matrix size

Use the X, Y and Z steppers to add or remove spins (X × Y × Z). Sequences can set the matrix with the SimmrMatrixSize directive.

The ••• button at the top right of the Spins panel opens the spin options:

OptionDescription
Spin Vector HelpShows instructions for the Spins view.
Lab FrameOff: rotating frame (default). On: laboratory frame, where spins also precess at the carrier frequency.
Show B1Shows an orange RF rotation-axis vector while RF is on, normalized to the peak RF amplitude.
LabelsShows text labels on the spins. Only appears when the scan subject has labels.
Show Trail…Draws a trail of each magnetization arrow tip over the last 0–2 ms (off by default).
Fade Unexcited… *Fades spins with little transverse signal (0–25%), so excited spins stand out.
Spin Rendering…Chooses how spins are drawn, and their size — see below.
Add ObjectCreates a new, named custom array object.
Select SpinTap a spin in a custom object to edit its position, T1, T2, diffusivity, label and label offset (Δx/Δy/Δz), static Δf and spin size, or to duplicate or delete it. Objects can also be defined in a sequence file — see Custom scan object.

* Only available in Advanced mode (toggle Advanced in Settings).

Vector averages: the average vector controls show the global XYZ average vector, or averages along X, Y or Z rows. Optionally average the transverse component only.

Spin rendering

Choose Spin Rendering… in the ••• menu. The first three options show spin direction; the last three show magnitude:

Below the options, Sphere Size sets the sphere diameter from 0 to 70% (default 40%); set it to 0 to see vector length clearly. Proportional to |m| scales each sphere with its magnetization magnitude.

Spin rendering options: Mini Magnets, Phase Gray, Gray |Mxy| and |Mxy|phase

Video export

Export Video records the simulation through the full waveform duration at 30 fps, capturing the spins and waveforms as a QuickTime movie you can save or share.