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 thedesignextra 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.
Noneselectsstartup_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:
- 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