cylinder_2d

Simple cylindrical phantoms generated with different contrasts.

mr_utils.test_data.phantom.cylinder_2d.bssfp_2d_cylinder(TR=0.006, alpha=1.0471975511965976, dims=(64, 64), FOV=((-1, 1), (-1, 1)), radius=0.5, field_map=None, phase_cyc=0, kspace=False)[source]

Simulates axial bSSFP scan of cylindrical phantom.

Parameters:
  • TR (float, optional) – Repetition time.
  • alpha (float, optional) – Flip angle (in rad).
  • dims (tuple of ints, optional) – Matrix size, (dim_x,dim_y)
  • FOV (tuple of tuples, optional) – Field of view in arbitrary units: ( (x_min,x_max), (y_min,y_max) )
  • radius (float, optional) – Radius of cylinder in arbitrary units.
  • field_map (array_like, optional) – (dim_x,dim_y) field map. If None, linear gradient in x used.
  • phase_cyc (float, optional) – Phase cycling used in simulated bSSFP acquisition (in rad).
  • kspace (bool, optional) – Whether or not to return data in kspace or imspace.
Returns:

im – Complex simulated image with bSSFP contrast.
Return type:

array_like
mr_utils.test_data.phantom.cylinder_2d.cylinder_2d(dims=(64, 64), FOV=((-1, 1), (-1, 1)), radius=0.5, params=None)[source]

Base 2d cylinder maps to feed to contrast simulations.

Parameters:
  • dims (tuple of ints, optional) – Size of 2d cylinder.
  • FOV (tuple of tuples, optional) – Field of view as ((x_lo, x_hi), (y_lo, y_hi)).
  • radius (float, optional) – Radius of cylinder with respect to FOV.
  • params (dict, optional) – Dictionary of tissue properties, as in cylinder_2d_params.
Returns:

  • PD (array_like) – Proton density map.
  • T1s (array_like) – T1 map.
  • T2s (array_like) – T2 map.
mr_utils.test_data.phantom.cylinder_2d.cylinder_2d_params()[source]

Returns properties of numerical phantom used in cylinder_2d.

Returns:params – Dictionary of example T1, T2, and M0 values.
Return type:dict
mr_utils.test_data.phantom.cylinder_2d.spgr_2d_cylinder(TR=0.3, TE=0.003, alpha=1.0471975511965976, dims=(64, 64), FOV=((-1, 1), (-1, 1)), radius=0.5, field_map=None, kspace=False)[source]

Simulates axial spoiled GRE scan of cylindrical phantom.

Parameters:
  • TR (float, optional) – Repetition time.
  • TE (float, optional) – Echo time.
  • alpha (float, optional) – Flip angle (in rad).
  • dims (tuple of ints, optional) – Matrix size, (dim_x,dim_y)
  • FOV (tuple of tuples, optional) – Field of view in arbitrary units, ( (x_min,x_max), (y_min,y_max) )
  • radius (float, optional) – Radius of cylinder in arbitrary units.
  • field_map (array_like, optional) – (dim_x,dim_y) field map. If None, linear gradient in x used.
  • kspace (bool, optional) – Whether or not to return data in kspace or imspace.
Returns:

im – Complex simulated image with spoiled GRE contrast.
Return type:

array_like