make_busse_schedule

make_busse_schedule#

pypulseqpp.make_busse_schedule()[source]#

Construct a prescribed-PSS refocusing train with inverse EPG.

The train is designed by blochsim.trains.busse_flips, which the design extra installs. The first and final pulses use the maximum angle. An initial asymptotic approach establishes the low-angle state; PSS coherence then increases through the centre control toward the final control. A shooting correction enforces the actual minimum, centre and final RF angles. The output is independent of echo spacing: relaxation belongs to the forward EPG model.

Parameters:
  • length (int) – Total number of refocusing pulses, including startup pulses.

  • minimum_flip_angle (float, default=np.deg2rad(25.0)) – Minimum actual refocusing angle (rad).

  • centre_flip_angle (float, default=np.deg2rad(70.0)) – Actual refocusing angle at centre_echo (rad).

  • maximum_flip_angle (float, default=np.deg2rad(120.0)) – Actual first and final refocusing angle (rad).

  • centre_echo (int | None, default=None) – Zero-based RF pulse index, including startup pulses. None selects startup_echoes + (length - startup_echoes - 1) // 2.

  • startup_echoes (int, default=6) – Leading unacquired pulses, used to locate the default centre. The caller excludes their ADC events; this function emits angles only.

  • initial_decay (float, default=1.3) – Initial exponential time constant (echoes). This reconstruction parameter is not specified numerically in the reference paper.

Returns:

Actual RF flip angles (rad), shape (length,), including startup. Each call returns an independent array.

Return type:

numpy.ndarray

Raises:
  • ValueError – If counts or controls are invalid, the centre is not after RF6 and before the final pulse, or the prescribed train is infeasible.

  • ImportError – If blochsim is not installed.

Notes

Controls satisfy 0 < minimum < centre < maximum < pi. The signal segments use powers 1.5 before the centre and 1 afterward [1]. No relaxation, transmit inhomogeneity or slice profile enters the inversion. These effects can be evaluated while optimizing the angle controls with an outer forward-EPG objective; the constructor remains the same.

Examples

>>> import numpy as np
>>> import pypulseqpp as pp
>>> angles = pp.make_busse_schedule(106)
>>> angles.shape
(106,)
>>> np.allclose(np.rad2deg(angles[[np.argmin(angles), 55, -1]]), [25, 70, 120])
True

References