2D Trajectories

A collection of 2D non-Cartesian trajectories with analytical definitions.

Hereafter we detail and illustrate the different arguments used in the parameterization of 2D non-Cartesian trajectories. Since most arguments are redundant across the different patterns, some of the documentation will refer to previous patterns for explanation.

Note that most sources have not been added yet, but will be in the near future.

# External
import matplotlib.pyplot as plt
import numpy as np

# Internal
import mrinufft as mn

from mrinufft import display_2D_trajectory


# Util function to display varying arguments
def show_argument(function, arguments, one_shot, subfigure_size):
    # Initialize trajectories with varying option
    trajectories = [function(arg) for arg in arguments]

    # Plot the trajectories side by side
    fig = plt.figure(
        figsize=(len(trajectories) * subfigure_size, subfigure_size),
        constrained_layout=True,
    )
    subfigs = fig.subfigures(1, len(trajectories))
    for subfig, arg, traj in zip(subfigs, arguments, trajectories):
        ax = display_2D_trajectory(
            traj,
            size=subfigure_size,
            one_shot=one_shot,
            subfigure=subfig,
        )
        ax.set_aspect("equal")
        ax.set_title(str(arg), fontsize=4 * subfigure_size)
    plt.show()


def show_trajectory(trajectory, one_shot, figure_size):
    ax = display_2D_trajectory(trajectory, size=figure_size, one_shot=one_shot)
    ax.set_aspect("equal")
    plt.tight_layout()
    plt.show()

Script options

These options are used in the examples below as default values for all trajectories.

# Trajectory parameters
Nc = 24  # Number of shots
Ns = 256  # Number of samples per shot
in_out = True  # Choose between in-out or center-out trajectories
tilt = "uniform"  # Choose the angular distance between shots
nb_repetitions = 6  # Number of strips when relevant

# Display parameters
figure_size = 6  # Figure size for trajectory plots
subfigure_size = 3  # Figure size for subplots
one_shot = True  # Highlight one shot in particular

Circular patterns

Radial

The most basic non-Cartesian trajectory composed of straight lines with no customization arguments besides the common ones.

Arguments:

• Nc (int): number of individual shots

• Ns (int): number of samples per shot

• tilt (str, float): angle between each consecutive shot (in radians) (default "uniform")

• in_out (bool): define whether the shots should travel toward the center then outside (in-out) or not (center-out). (default False)

trajectory = mn.initialize_2D_radial(Nc, Ns, tilt=tilt, in_out=in_out)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

Nc (int)

The number of individual shots, here straight lines, used to cover the k-space. More shots means better coverage but also longer acquisitions.

arguments = [8, 16, 32, 64]
function = lambda x: mn.initialize_2D_radial(x, Ns, tilt=tilt, in_out=in_out)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Ns (int)

The number of samples per shot. More samples means the lines are split into more smaller segments, and therefore either the acquisition window is lengthened or the sampling rate is increased.

arguments = [8, 16, 32, 64]
function = lambda x: mn.initialize_2D_radial(Nc, x, tilt=tilt, in_out=in_out)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

tilt (str, float)

The angle between each consecutive shots, either in radians or as a string defining some default mods such as “uniform” for \(2 \pi / N_c\), or “golden” and “mri golden” for the different common definitions of golden angles. The angle is automatically adapted when the in_out argument is switched to keep the same behavior.

arguments = ["uniform", "golden", "mri-golden", np.pi / 17]
function = lambda x: mn.initialize_2D_radial(Nc, Ns, tilt=x, in_out=in_out)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

in_out (bool)

It allows to switch between different ways to define how the shot should travel through the k-space:

• in-out: starting from the outer regions, then passing through the center then going back to outer regions, often on the opposite side (radial, cones)

• center-out or center-center: when in_out=False the trajectory will start at the center, but depending on the specific trajectory formula the path might end up in the outer regions (radial, spiral, cones, etc) or back to the center (rosette, lissajous).

Note that the behavior of tilt is automatically adapted to the changes to avoid having to update it too when switching in_out.

arguments = [True, False]
function = lambda x: mn.initialize_2D_radial(Nc, Ns, tilt=tilt, in_out=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Spiral

A generalized function that generates spirals defined through the \(r = a \theta^{1/n}\) equality, with \(r\) the radius and \(\theta\) the polar angle. Note that the most common spirals, Archimedes and Fermat, are subcases of this equation.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• tilt (str, float): angle between each consecutive shot (in radians). (default "uniform"). See radial

• in_out (bool): define whether the shots should travel toward the center then outside (in-out) or not (center-out). (default False). See radial

• nb_revolutions (float): number of revolutions performed from the center. (default 1)

• spiral (str, float): type of spiral defined through the above-mentionned equation. (default "archimedes")

trajectory = mn.initialize_2D_spiral(Nc, Ns, tilt=tilt, in_out=in_out)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

nb_revolutions (float)

The number of revolutions performed from the center (i.e. performed twice for in-out trajectories).

arguments = [1 / 8, 1 / 2, 1, 3]
function = lambda x: mn.initialize_2D_spiral(
    Nc, Ns, tilt=tilt, nb_revolutions=x, in_out=in_out
)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

spiral (str, float)

The shape of the spiral defined through \(n\) in the \(r = a \theta^{1/n}\) equality, with \(r\) the radius and \(\theta\) the polar angle. Both "archimedes" and "fermat" are available as string options for convenience.

arguments = ["archimedes", "fermat", 0.5, 1.5]
function = lambda x: mn.initialize_2D_spiral(Nc, Ns, tilt=tilt, spiral=x, in_out=in_out)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Cones

A radial-like trajectory zigzaging within cones over the k-space to offer a better coverage than radial with more customization parameters.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• tilt (str, float): angle between each consecutive shot (in radians). (default "uniform"). See radial

• in_out (bool): define whether the shots should travel toward the center then outside (in-out) or not (center-out). (default False). See radial

• nb_zigzags (float): number of sinusoidal patterns over a center-out shot. (default 5)

• width (float): cone width factor, normalized to cover the k-space by default. (default 1)

trajectory = mn.initialize_2D_cones(Nc, Ns, tilt=tilt, in_out=in_out)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

nb_zigzags (float)

The number of “zigzags”, or sinusoidal patterns present over a center-out shot (doubled overall for in-out trajectories)

arguments = [0.5, 2, 5, 10]
function = lambda x: mn.initialize_2D_cones(
    Nc, Ns, tilt=tilt, in_out=in_out, nb_zigzags=x
)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

width (float)

The cone width normalized such that width = 1 corresponds to non-overlapping cones covering the whole k-space circle, and therefore width > 1 creates overlap between cone regions and width < 1 tends to more radial patterns.

arguments = [0.2, 1, 2, 3]
function = lambda x: mn.initialize_2D_cones(Nc, Ns, tilt=tilt, in_out=in_out, width=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Sinusoide

Another radial-like trajectory zigzaging similarly to cones, but over a whole band rather than cones reduced towards the center.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• tilt (str, float): angle between each consecutive shot (in radians).

• (default "uniform"). See radial

• in_out (bool): define whether the shots should travel toward the center then outside (in-out) or not (center-out). (default False). See radial

• nb_zigzags (float): number of sinusoidal patterns over a center-out shot. (default 5). See cones

• width (float): shot width factor, normalized to cover the k-space by default. (default 1). See cones

trajectory = mn.initialize_2D_sinusoide(Nc, Ns, tilt=tilt, in_out=in_out)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

PROPELLER

The PROPELLER trajectory is generally used along a specific reconstruction pipeline described in [Pip99] to correct for motion artifacts.

The acronym PROPELLER stands for Periodically Rotated Overlapping ParallEL Lines with Enhanced Reconstruction, and the method is also commonly known under other aliases depending on the vendor, with some variations: BLADE, MulitVane, RADAR, JET.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• nb_strips (int): number of strips covering the k-space. (default "uniform"). See radial

trajectory = mn.initialize_2D_propeller(Nc, Ns, nb_strips=nb_repetitions)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

nb_strips (int)

The number of individual strips dividing the k-space circle. It must divide the number of shots Nc, and it is recommended to choose it such that the ratio is even to cover the center.

arguments = [2, 3, 4, 6]
function = lambda x: mn.initialize_2D_propeller(Nc, Ns, nb_strips=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Rings

A pattern composed of concentric circles like a target, with each ring composed of one or more shots . This trajectory was initially proposed by Wu, Hochong H., Jin Hyung Lee, and Dwight G. Nishimura. “MRI using a concentric rings trajectory.” Magnetic Resonance in Medicine 59, no. 1 (2008): 102-112.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• nb_rings (int): number of rings used to partition the k-space. It should be lower than or equal to Nc.

trajectory = mn.initialize_2D_rings(Nc, Ns, nb_rings=Nc)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

nb_rings (int)

The number of rings used to partition the k-space. It should always be lower than or equal to \(N_c\) as the implementation does not permit shots to cover several rings. Note that to fully sample a k-space circle, it should be set around \(FOV / (2 * resolution)\).

arguments = [Nc, int(2 * Nc / 3), int(Nc / 3)]
function = lambda x: mn.initialize_2D_rings(Nc=x, Ns=Ns, nb_rings=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

This implementation allows using more shots than rings, and it will automatically attribute the additional shots to the longest rings to reduce the top gradient amplitude and slew rate.

arguments = [Nc, int(4 * Nc / 3), 2 * Nc]
function = lambda x: mn.initialize_2D_rings(Nc=x, Ns=Ns, nb_rings=Nc)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Rosette

A repeating pattern composed of a single long curve going through the center multiple times and split into multiple shots.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• in_out (bool): define whether the shots should travel toward the center then outside (in-out) or not (center-out). (default False). See radial

• coprime_index (int): the index of the coprime factor used to define the shot curvature. (default 0)

trajectory = mn.initialize_2D_rosette(Nc, Ns, in_out=in_out)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

coprime_index (int)

The index used to select a compatible coprime factor, parameterized such that trajectories keep \(N_c\) petals while increasing their width, i.e. increasing the curvature of the shots. This argument is quite complex with regard to the original formula in order to remain easily interpretable, user-friendly and optimal for MR use cases. For more details, please consult this Wikipedia page.

arguments = [0, 1, 5, 10]
function = lambda x: mn.initialize_2D_rosette(Nc, Ns, in_out=in_out, coprime_index=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Polar Lissajous

A polar version of the Lissajous curve, repeating pattern composed of a single long curve going through the center multiple times and split into multiple shots.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• in_out (bool): define whether the shots should travel toward the center then outside (in-out) or not (center-out). (default False). See radial

• coprime_index (int): the index of the coprime factor used # to define the shot curvature. (default 0)

• nb_segments (int): number of indepedent Lissajous curves covering different segments of the k-space. (default 1)

trajectory = mn.initialize_2D_polar_lissajous(Nc, Ns, in_out=in_out)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

coprime_index (int)

The index used to select a compatible coprime factor, and impacting the shot curvature. For now, it is less trivial to select than for rosette but it will be updated in the future.

arguments = [0, 3, 12, 15]
function = lambda x: mn.initialize_2D_polar_lissajous(
    Nc, Ns, in_out=in_out, coprime_index=x
)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

nb_segments (int)

The number of Lissajous curves and segmented regions of the k-space. The polar Lissajous curve natively puts emphasis on the center and along the \(k_y\) axis, but can be parameterized to rather emphasize nb_segments axes by reducing the coverage and duplicating a shorter curve.

In the example below, nb_segments = 2 emphasizes the diagonals as two Lissajous curves were created with each of them only covering two opposing quarters of the k-space. It implies that nb_segments should be a divider of Nc.

arguments = [1, 2, 3, 4, 6, 8, 12]
function = lambda x: mn.initialize_2D_polar_lissajous(
    Nc, Ns, in_out=in_out, nb_segments=x
)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Comments

This specific curve has never been used in MRI to the best of our knowledge, and was inspired by the MathCurve page. It is heavily related to the rosette trajectory but parameterized in a much more complex way, as shown below when varying both coprime_index and nb_segments. It is not necessarily fit for MR applications, but was added out of personal interest in an effort to explore potentially unexploited geometries.

for io in [True, False]:
    for cpi in [0, 6]:
        arguments = [1, 2, 4, 12]
        function = lambda x: mn.initialize_2D_polar_lissajous(
            Nc, Ns, in_out=io, coprime_index=cpi, nb_segments=x
        )
        show_argument(
            function, arguments, one_shot=one_shot, subfigure_size=subfigure_size
        )

• 
• 
• 
• 

Non-circular patterns

Waves

An extension of the Cartesian line-by-line pattern that simply adds sinusoidal variations along the \(k_y\) axis.

Arguments:

• Nc (int): number of individual shots. See radial

• Ns (int): number of samples per shot. See radial

• nb_zigzags (float): number of sinusoide patterns along a line. (default 5)

• width (float): line width normalized such that a width of 1 corresponds to covering the full band without overlapping other bands. (default 1)

trajectory = mn.initialize_2D_waves(Nc, Ns, nb_zigzags=5)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

nb_zigzags (float)

The number of sinusoidal patterns along a line, similar to cones and sinusoidal trajectories.

arguments = [1, 2.5, 5, 10]
function = lambda x: mn.initialize_2D_waves(Nc, Ns, nb_zigzags=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

width (float)

The line width normalized such that width = 1 corresponds to non-overlapping lines covering (almost) uniformly the whole k-space, and therefore width > 1 creates overlap between regions and width < 1 tends to Cartesian patterns. Also notes that increasing width squeezes the lines together such that shots at the top and bottom borders don’t spread ouf of the k-space, resulting in non-covered areas with large widths. This behavior might be subject to changes in future versions.

arguments = [0, 1, 1.5, 3]
function = lambda x: mn.initialize_2D_waves(Nc, Ns, width=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

Lissajous

The classic Lissajous patterns composed of a long single curve split into shots with different curve profiles and covering the whole k-space square. This pattern tends to be more dense on the edges, as opposed to most others. Note that the original pattern is much more complex but has been simplified to match MR purposes, with a balanced distribution and minimal overlapping.

Arguments:

• Nc (int): number of individual shots

• Ns (int): number of samples per shot

• density (float): controls the pseudo-grid density and shot curvatures. (default "1")

trajectory = mn.initialize_2D_lissajous(Nc, Ns, density=1)
show_trajectory(trajectory, figure_size=figure_size, one_shot=one_shot)

density (float)

It relates to both the curve length and curvature, normalized such that density = 1 corresponds to pseudo-diagonal curves for any given \(N_c\).

arguments = [1, 1.5, 2, 3]
function = lambda x: mn.initialize_2D_lissajous(Nc, Ns, density=x)
show_argument(function, arguments, one_shot=one_shot, subfigure_size=subfigure_size)

References

[Pip99]

Pipe, James G. “Motion correction with PROPELLER MRI: application to head motion and free‐breathing cardiac imaging.” Magnetic Resonance in Medicine 42, no. 5 (1999): 963-969.