calc_fse_effective_te

calc_fse_effective_te#

pypulseqpp.calc_fse_effective_te()[source]#

Calculate contrast-equivalent TE by relaxation-normalized CPMG EPG.

Parameters:
  • flip_angles (array_like) – Refocusing flip angles (rad), shape (..., echoes). Startup pulses are included. Angles must lie in [0, pi].

  • echo_spacing (float) – Time between successive echoes (s), positive.

  • first_echo_time (float | None, default=None) – Excitation-to-first-echo time (s). None uses echo_spacing. Each refocusing pulse bisects the preceding echo interval.

  • reference_t1 (float, default=1.0) – Reference longitudinal relaxation time (s), positive and finite.

  • reference_t2 (float, default=0.1) – Reference transverse relaxation time (s), positive and finite.

Returns:

Contrast-equivalent echo times (s), shape matching flip_angles. A zero-coherence echo is undefined and returned as nan.

Return type:

numpy.ndarray

Raises:
  • ValueError – If angles, timing or reference relaxation times are invalid.

  • ImportError – If blochsim is not installed.

Notes

For a fully relaxed, ideal 90-degree excitation and instantaneous CPMG refocusing, EPG computes signal with reference relaxation and with no relaxation. The result is -reference_t2 * log(abs(S / S_no_relax)) [1]. No RF-pulse duration, slice profile, off-resonance, transmit-field variation or inter-shot steady state is modeled. This is a reference contrast annotation, not a tissue-independent prediction. At 180-degree refocusing it equals physical echo time. The echoes are computed by blochsim.trains.effective_te, which the design extra installs; PyTorch is not imported.

Examples

>>> import numpy as np
>>> import pypulseqpp as pp
>>> np.allclose(pp.calc_fse_effective_te([np.pi] * 3, 0.004), [0.004, 0.008, 0.012])
True

References