SpatialSelective2DExcitation

SpatialSelective2DExcitation#

class pypulseqpp.sequences.SpatialSelective2DExcitation[source]#

Bases: RfModule

Small-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). None is 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. None samples 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, target does not match matrix, 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:

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

(svg)#

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