dcmri.fake_tissue2scan#

dcmri.fake_tissue2scan(tacq=180.0, tbreak=60, dt=1.5, BAT=20, Fb=0.1, vb=0.05, PS=0.003, vi=0.2, field_strength=3.0, agent='gadodiamide', H=0.45, R10a=0.614, R10=0.708215297450425, S0b1=100, S01=150, S0b2=200, S02=300, model='SS', TR=0.005, FA=15, TC=0.2, CNR=inf, dt_sim=0.1)[source]#

Synthetic data generated using Parker’s AIF, a two-compartment exchange tissue and a steady-state sequence.

Parameters:

  • tacq (float, optional) – Duration of the acquisition in sec. Defaults to 180.

  • tbreak (float, optional) – Break time between the two scans in sec. Defaults to 60.

  • dt (float, optional) – Sampling inteval in sec. Defaults to 1.5.

  • BAT (int, optional) – Bolus arrival time in sec. Defaults to 20.

  • Fb (float, optional) – Blood flow in mL/sec/mL. Defaults to 0.1.

  • vb (float, optional) – Blood volume fraction. Defaults to 0.05.

  • PS (float, optional) – Permeability-surface area product in 1/sec. Defaults to 0.003.

  • vi (float, optional) – Interstitial volume fraction. Defaults to 0.3.

  • field_strength (float, optional) – B0 field in T. Defaults to 3.0.

  • agent (str, optional) – Contrast agent generic name. Defaults to ‘gadodiamide’.

  • H (float, optional) – Hematocrit. Defaults to 0.45.

  • R10a (_type_, optional) – Precontrast relaxation rate for blood in 1/sec. Defaults to 1/dc.T1(3.0, ‘blood’).

  • R10 (int, optional) – Precontrast relaxation rate for tissue in 1/sec. Defaults to 1.

  • S0b1 (int, optional) – Signal scaling factor for blood in the first scan (arbitrary units). Defaults to 100.

  • S01 (int, optional) – Signal scaling factor for tissue in the first scan (arbitrary units). Defaults to 150.

  • S0b2 (int, optional) – Signal scaling factor for blood in the second scan (arbitrary units). Defaults to 100.

  • S02 (int, optional) – Signal scaling factor for tissue in the second scan (arbitrary units). Defaults to 150.

  • model (str, optional) – Scanning sequences, either steady-state (‘SS’) or saturation-recovery (‘SR’)

  • TR (float, optional) – Repetition time in sec. Defaults to 0.005.

  • FA (int, optional) – Flip angle. Defaults to 15.

  • TC (float, optional) – time to center of k-space in SR sequence. This is ignored when sequence=’SS’. Defaults to 0.2 sec.

  • CNR (float, optional) – Contrast-to-noise ratio, define as the ratio of signal-enhancement in the AIF to noise. Defaults to np.inf.

  • dt_sim (float, optional) – Sampling inteval of the forward modelling in sec. Defaults to 0.1.

Returns:

time, aif, roi, gt

  • time: tuple with two arrays of time points.

  • aif: tuple with two arrays of AIF signals.

  • roi: tuple with two arrays of ROI signals.

  • gt: dictionary with ground truth values for concentrations and tissue parameters.

Return type:

tuple