T2Preparation#
- class pypulseqpp.sequences.T2Preparation[source]#
Bases:
RfModuleAdiabatic 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_DERATEofsystem.max_b1is lengthened at the same adiabaticity and swept bandwidth, up toADIABATIC_MAX_STRETCH(2) times its duration, and past it held there with its adiabaticity lowered, to no less thanADIABATICITY_FLOOR(0.75) ofadiabaticity.- 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 – seeT1T2Preparation.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_cyclesis 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_tipis not'up'or'down',n_refocusis 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:
Methods
Build the module's block layout; implemented by the subclass. |
|
Publish events from the caller's locals and register keyword aliases. |
|
Publish named events, whether or not they were added to a block. |
|
Simulate this module's pulse across off-resonance. |
Attributes