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).
Noneusesecho_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 asnan.- Return type:
- 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 byblochsim.trains.effective_te, which thedesignextra 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