deepmr.bloch.t1t2shuffling#
- deepmr.bloch.t1t2shuffling(flip, phases, ESP, TR, T1, T2, sliceprof=False, diff=None, device='cpu', **kwargs)[source]#
Simulate a T1T2Shuffling Spin Echo sequence. Only single-pool for now.
- Parameters:
flip (float | np.ndarray | torch.Tensor) – Flip angle in
[deg]
of shape(npulses,)
or(npulses, nmodes)
.phases (float | np.ndarray | torch.Tensor) – Refocusing angle phases in
[deg]
of shape(npulses,)
or(npulses, nmodes)
.ESP (float) – Echo spacing in [ms].
TR (float) – Repetition time in [ms].
T1 (float | np.ndarray | torch.Tensor) – Longitudinal relaxation time for main pool in
[ms]
.T2 (float | np.ndarray | torch.Tensor) – Transverse relaxation time for main pool in
[ms]
.sliceprof (float | np.ndarray | torch.Tensor) – Excitation slice profile (i.e., flip angle scaling across slice). If
False
, pulse are non selective. IfTrue
, pulses are selective but ideal profile is assumed. If array, flip angle scaling along slice is simulated. Defaults toFalse
.spoil_inc (float, optional) – RF spoiling increment in
[deg]
. Defaults to117°
.diff (str | tuple[str], optional) – String or tuple of strings, saying which arguments to get the signal derivative with respect to. Defaults to
None
(no differentation).device (str) – Computational device (e.g.,
cpu
orcuda:n
, withn=0,1,2...
). Defaults tocpu
.nstates (int, optional) – Maximum number of EPG states to be retained during simulation. High numbers improve accuracy but decrease performance. Defaults to
10
.max_chunk_size (int, optional) – Maximum number of atoms to be simulated in parallel. High numbers increase speed and memory footprint. Defaults to
natoms
.verbose (bool, optional) – If
True
, prints execution time for signal (and gradient) calculations. Defaults toFalse
.B1 (float | np.ndarray | torch.Tensor , optional) – Flip angle scaling factor (
1.0 := nominal flip angle
). Defaults toNone
.B0 (float | np.ndarray | torch.Tensor , optional) – Bulk off-resonance in [Hz]. Defaults to
None
B1Tx2 (float | np.ndarray | torch.Tensor) – Flip angle scaling factor for secondary RF mode (
1.0 := nominal flip angle
). Defaults toNone
.B1phase (float | np.ndarray | torch.Tensor) – B1 relative phase in
[deg]
. (0.0 := nominal rf phase
). Defaults toNone
.