SpatialSelective2DExcitation#
- class pypulseqpp.sequences.SpatialSelective2DExcitation[source]#
Bases:
RfModuleSmall-tip spiral excitation selective in two dimensions.
The selected disc extends along the unencoded axis. Its periodic replicas lie at the excitation FOV distance, which should cover the object. Each arm is retraced with RF off, so the trajectory ends at the origin and needs no rephaser.
- Parameters:
system (pypulseqpp.Opts) – System limits.
flip_angle_deg (float) – Flip angle (degrees) at the centre of the disc.
fov (float) – Square excitation field of view (m); the distance to the first repeated disc.
matrix (int) – Excitation grid size, square; sets the extent of the trajectory in excitation k-space.
selective_size (float or sequence of float, default=None) – Diameter of the excited disc (m).
Noneis half the field of view.target (numpy.ndarray, default=None) – Complex profile on the
(matrix, matrix)grid, instead of a disc.n_interleaves (int, default=None) – Spiral arms played.
Nonesamples excitation k-space at Nyquist; fewer arms give a proportionally shorter pulse and a repeated disc proportionally closer.axes (sequence of str, default=('x', 'y')) – The two gradient channels the trajectory runs on.
use (str, default='excitation') – Pulseq RF use tag.
- Attributes:
rf (RfEvent) – The pulse.
gradients (tuple of GradEvent) – One per axis, played in the pulse’s own block.
rephasers (tuple of TrapEvent) – Rephasing gradients; empty, because the spiral trajectory ends at the origin.
self_refocused (bool) – Whether the excitation k-space trajectory ends at the origin without a rephaser.
duration_s (float) – Pulse length (s), set by the trajectory.
- Raises:
ValueError – If a size is out of range,
targetdoes not matchmatrix, or the requested profile has no response on the trajectory.
Examples
>>> import pypulseqpp.sequences as design >>> import pypulseqpp as pp >>> system = pp.Opts(max_grad=40, grad_unit="mT/m", max_slew=150, slew_unit="T/m/s") >>> pencil = design.SpatialSelective2DExcitation( ... system, 30.0, fov=0.256, matrix=32, selective_size=0.04 ... ) >>> len(pencil.blocks), [gradient.channel for gradient in pencil.gradients] (1, ['x', 'y'])
>>> pencil.self_refocused, pencil.rephasers (True, ())
The subpulse train under the spiral gradients, and the transverse magnetisation over the selected plane:
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