T2Preparation

Contents

T2Preparation#

class pypulseqpp.sequences.T2Preparation[source]#

Bases: RfModule

Adiabatic T2 preparation with tip-down, refocusing and storage pulses.

The refocusing pulses come in pairs, which cancels their B1-dependent phase. The storing half passage is the time-reversed, conjugated tip-down half passage. A half passage or refocusing pulse whose peak exceeds MAX_B1_DERATE of system.max_b1 is lengthened at the same adiabaticity and swept bandwidth, up to ADIABATIC_MAX_STRETCH (2) times its duration, and past it held there with its adiabaticity lowered, to no less than ADIABATICITY_FLOOR (0.75) of adiabaticity.

Parameters:
  • system (pypulseqpp.Opts) – System limits.

  • echo_time_s (float) – Preparation echo time (s), from the centre of the tip-down pulse to that of the storing pulse.

  • final_tip ({'up', 'down'}, default='up') – Store on +z (pure T2 weighting) or -z, which starts a T1 recovery as well – see T1T2Preparation.

  • n_refocus (int, default=2) – Adiabatic refocusing pulses, spaced evenly through the echo time; even and at least 2.

  • half_passage_duration_s (float, default=0.004) – Duration of each half passage (s) while it fits the system’s peak B1.

  • refocusing_duration_s (float, default=0.01024) – Duration of each refocusing pulse (s) while it fits the system’s peak B1.

  • adiabaticity (float, default=8) – Sweep-rate margin over the adiabatic condition, of every pulse, while it fits the system’s peak B1.

  • dwell_s (float, default=1e-05) – RF raster (s).

  • spoiling_cycles (float, default=4.0) – Cycles of dephasing of the closing spoiler on each axis across voxel_size_m. Zero omits the spoiler block.

  • voxel_size_m (float, default=0.001) – Length the dephasing is counted over (m).

  • labels (sequence of str, default=None) – Labels set to 0 on the first pulse’s block, to be changed per shot by the caller.

Attributes:
  • rf_prep (RfEvent) – The half passage that tips down.

  • rf_ref (RfEvent) – The refocusing pulse; every repeat plays this one event.

  • rf_store (RfEvent) – The reverse half passage that stores what is left.

  • half_passage_duration, refocusing_duration (float) – Durations the half passages and the refocusing pulse were designed at (s): the requested ones, or longer under the system’s peak B1.

  • half_passage_adiabaticity, refocusing_adiabaticity (float) – Adiabaticities they were designed at: adiabaticity, or lower under the system’s peak B1.

  • wait_first, wait_inner, wait_last (DelayEvent) – The gaps before the first refocusing pulse, between refocusing pulses, and before rf_store. Each is absent when its gap is zero.

  • gx_spoil, gy_spoil, gz_spoil (GradEvent) – Spoiler gradient of each axis; absent when spoiling_cycles is zero.

  • prep_labels (LabelSetEvent or list of LabelSetEvent) – One per name in labels.

  • echo_time (float) – Achieved preparation echo time (s), after rounding the gaps to the block raster.

Raises:

ValueError – If final_tip is not 'up' or 'down', n_refocus is not a positive even number, a size is out of range, the echo time is shorter than the pulses themselves, or a pulse cannot fit the system’s peak B1.

Examples

>>> import pypulseqpp.sequences as design
>>> import pypulseqpp as pp
>>> prep = design.T2Preparation(pp.Opts(), 50e-3)
>>> round(prep.echo_time * 1e3, 2)
49.99

Tip-down, two refocusing pulses and storage. Over the band the refocusing pulses cover, the module returns the magnetisation to +z; what it lost on the way is the T2 weighting:

../_images/pypulseqpp-sequences-T2Preparation-1_00.svg

(svg)#

../_images/pypulseqpp-sequences-T2Preparation-1_01.svg

(svg)#

Methods

init_module

Build the module's block layout; implemented by the subclass.

publish

Publish events from the caller's locals and register keyword aliases.

register

Publish named events, whether or not they were added to a block.

sim_rf

Simulate this module's pulse across off-resonance.

Attributes

blocks

Block tuples in play order, holding the original event objects.

duration

Duration of the module (s).

seq

Sequence holding the module's construction-time block layout.