make_gauss_pulse

make_gauss_pulse#

pypulseqpp.make_gauss_pulse()[source]#

Create a [optionally slice selective] Gauss pulse.

See also pypulseq.Sequence.sequence.Sequence.add_block().

Parameters:

  • flip_angle (float) – Flip angle in radians.

  • apodization (float, default=0) – Apodization.

  • bandwidth (float, default=0) – Bandwidth in Hertz (Hz).

  • center_pos (float, default=0.5) – Position of peak.

  • delay (float, default=0) – Delay in seconds (s).

  • dwell (float, default=0)

  • duration (float, default=4e-3) – Duration in seconds (s).

  • freq_offset (float, default=0) – Frequency offset in Hertz (Hz).

  • max_grad (float, default=0) – Maximum gradient strength of accompanying slice select trapezoidal event.

  • max_slew (float, default=0) – Maximum slew rate of accompanying slice select trapezoidal event.

  • phase_offset (float, default=0) – Phase offset in Hertz (Hz).

  • return_gz (bool, default=False) – Boolean flag to indicate if the slice-selective gradient has to be returned.

  • slice_thickness (float, default=0) – Slice thickness of accompanying slice select trapezoidal event. The slice thickness determines the area of the slice select event.

  • system (Opts, default=Opts()) – System limits.

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

  • use (str, default='undefined') – Use of radio-frequency Gauss pulse event. Must be one of ‘excitation’, ‘refocusing’, ‘inversion’, ‘saturation’, ‘preparation’, ‘other’, ‘undefined’.

  • freq_ppm (float, default=0) – PPM frequency offset.

  • phase_ppm (float, default=0) – PPM phase offset.

Returns:

  • rf (SimpleNamespace) – Radio-frequency gauss pulse event.

  • gz (SimpleNamespace, optional) – Accompanying slice select trapezoidal gradient event.

  • gzr (SimpleNamespace, optional) – Accompanying slice select rephasing trapezoidal gradient event.

Raises:

ValueError – If invalid use is passed. If return_gz=True and slice_thickness was not passed.

Notes

This is PyPulseq’s factory; the event it builds is returned with its fields in slots.