IhMtPreparation

Contents

IhMtPreparation#

class pypulseqpp.sequences.IhMtPreparation[source]#

Bases: OffResonanceSaturation

Simultaneous dual-offset saturation for ihMT measurements.

Each band has 1/sqrt(2) of the amplitude of the single-offset pulse of the same flip_angle_deg, so the deposited power equals that of one single-offset pulse.

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

  • flip_angle_deg (float, default=500.0) – Flip angle (degrees) of the matched single-offset pulse.

  • freq_offset_hz (float, default=1500.0) – Offset of each band from water (Hz), positive; bands are placed at both signs.

  • duration_s (float, default=0.008) – Pulse duration (s).

  • time_bw_product (float, default=4.0) – Time-bandwidth product of each band.

  • n_pulses (int, default=1) – Pulses in the train.

  • spoiling_cycles (float, default=4.0) – Cycles of dephasing of the closing spoiler across voxel_size_m. Zero omits the spoiler, for a pulse used for its phase effect.

  • 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 dual-band pulse.

  • 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.

  • band_offsets_hz (numpy.ndarray) – Frequency offsets of the two bands (Hz).

Raises:

ValueError – If freq_offset_hz, duration_s or time_bw_product is not positive. If n_pulses is below one, or a spoiling argument is out of range.

Examples

>>> import pypulseqpp.sequences as design
>>> import pypulseqpp as pp
>>> ihmt = design.IhMtPreparation(pp.Opts())
>>> ihmt.band_offsets_hz.tolist()
[-1500.0, 1500.0]

Both sidebands at once, with the same total RF power as one band played alone:

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

(svg)#

../_images/pypulseqpp-sequences-IhMtPreparation-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.