2D Cartesian gradient echo

2D Cartesian gradient echo#

Family:

Gradient echo

Dimensionality:

2D, multi-slice

Sampling:

Cartesian

Readout:

One phase-encode line per repetition, RF-spoiled

RF-spoiled, multi-slice 2D Cartesian gradient echo.

Prescription#

pypulseqpp.sequences.gre2D_sequence()#

RF-spoiled, multi-slice 2D Cartesian gradient echo.

One line per repetition. Slices one TR cannot hold are dealt round-robin into packets, played one after another; within a packet the even slices are excited before the odd ones. Every packet starts with its own dummy repetitions, and the last slice of a packet waits out the rest of the TR. Under undersampling the calibration lines are acquired first, marked IMA.

Up to six spatial saturation bands (sat1_* to sat6_*) are played before every excitation, in that order. Each lies in the physical frame, centred position from the isocentre along its normal, and the field-of-view offset and rotation leave it there.

Parameters:
  • system (pypulseqpp.Opts, default=None) – System limits, held under the module’s MAX_GRAD (80 mT/m) and MAX_SLEW (200 T/m/s). None is pypulseqpp.Opts().

  • fov_x (float, default=0.22) – Field of view along the readout and the phase encode (m).

  • fov_y (float, default=0.22) – Field of view along the readout and the phase encode (m).

  • n_x (int, default=128) – Readout matrix size.

  • n_y (int, default=128) – Phase-encode matrix size.

  • n_slices (int, default=1) – Number of slices.

  • slice_thickness (float, default=0.005) – Slice thickness (m).

  • slice_spacing (float, default=0.0) – Gap between adjacent slices (m); zero is contiguous.

  • flip_angle_deg (float, default=12.0) – Excitation flip angle (degrees).

  • te (float | None, default=0.008) – Echo time (s). None is as short as the readout admits.

  • tr (float | None, default=0.25) – Repetition time between successive excitations of one slice (s). None is as short as possible, and puts every slice in one packet.

  • readout_bandwidth_hz (float, default=250000.0) – Requested receiver bandwidth (Hz). What was achieved is the readout module’s bandwidth_hz.

  • ry (int, default=1) – Phase-encode undersampling: one line in every ry is acquired, the centre line among them.

  • partial_fourier_x (float, default=1.0) – Fraction of the echo acquired, in [0.75, 1]. Truncates the samples before the echo, which shortens the minimum TE.

  • partial_fourier_y (float, default=1.0) – Fraction of the phase-encode extent acquired, in [0.75, 1]. Truncates the lines before the centre.

  • n_dummy (int | None, default=None) – Non-acquiring repetitions before the first line of each packet. None plays as many as bring the steady state within 1 % (steady_state_dummies()).

  • readout_oversampling (float, default=2.0) – Readout oversampling factor, at least one.

  • n_acs_y (int, default=24) – Fully sampled calibration lines at the centre of k-space, acquired ahead of the rest when ry > 1.

  • sat1_normal_x (float, default=0.0) – Normal of the first spatial saturation band along the physical gradient axes. Normalised; not the zero vector for a band with a thickness.

  • sat1_normal_y (float, default=0.0) – Normal of the first spatial saturation band along the physical gradient axes. Normalised; not the zero vector for a band with a thickness.

  • sat1_normal_z (float, default=0.0) – Normal of the first spatial saturation band along the physical gradient axes. Normalised; not the zero vector for a band with a thickness.

  • sat1_position (float, default=0.0) – Centre of the first band along its normal, from the isocentre (m).

  • sat1_thickness (float, default=0.0) – Thickness of the first band (m). Zero plays no band.

  • sat2_normal_x (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat2_normal_y (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat2_normal_z (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat3_normal_x (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat3_normal_y (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat3_normal_z (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat4_normal_x (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat4_normal_y (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat4_normal_z (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat5_normal_x (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat5_normal_y (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat5_normal_z (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat6_normal_x (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat6_normal_y (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat6_normal_z (float, default=0.0) – Normals of the second to the sixth band, as for the first.

  • sat2_position (float, default=0.0) – Centres of the second to the sixth band along their normals, from the isocentre (m).

  • sat3_position (float, default=0.0) – Centres of the second to the sixth band along their normals, from the isocentre (m).

  • sat4_position (float, default=0.0) – Centres of the second to the sixth band along their normals, from the isocentre (m).

  • sat5_position (float, default=0.0) – Centres of the second to the sixth band along their normals, from the isocentre (m).

  • sat6_position (float, default=0.0) – Centres of the second to the sixth band along their normals, from the isocentre (m).

  • sat2_thickness (float, default=0.0) – Thicknesses of the second to the sixth band (m). Zero plays no band.

  • sat3_thickness (float, default=0.0) – Thicknesses of the second to the sixth band (m). Zero plays no band.

  • sat4_thickness (float, default=0.0) – Thicknesses of the second to the sixth band (m). Zero plays no band.

  • sat5_thickness (float, default=0.0) – Thicknesses of the second to the sixth band (m). Zero plays no band.

  • sat6_thickness (float, default=0.0) – Thicknesses of the second to the sixth band (m). Zero plays no band.

Returns:

The designed sequence.

Return type:

pypulseqpp.Sequence

Raises:

ValueError – If a partial Fourier fraction is outside [0.75, 1], ry is below one, a saturation band has a thickness and a zero normal or a negative thickness, or the TR cannot hold one slice.

Examples

>>> from pypulseqpp import sequences
>>> seq = sequences.gre2D_sequence(n_x=32, n_y=16, tr=None)
>>> seq.check_timing()[0]
True
>>> seq.definitions["Matrix"], seq.definitions["Name"]
([32.0, 16.0, 1.0], 'gre_2d')

Designed and drawn#

2D Cartesian gradient echo

2D Cartesian gradient echo

See also#

Other gradient echo sequences: gre3D_sequence, gre_multiecho2D_sequence, gre_multiecho3D_sequence, gre_radial2D_sequence, gre_stack_of_stars3D_sequence, gre_spiral2D_sequence, gre_stack_of_spirals3D_sequence, gre_propeller2D_sequence, gre_stack_of_blades3D_sequence.

The same sampling in another family: se2D_sequence, se3D_sequence, fse3D_sequence, mprage3D_sequence, bssfp2D_sequence, bssfp3D_sequence, epi2D_sequence.

Every shipped sequence is listed in the catalogue.