dcmri.fake_liver#

dcmri.fake_liver(tacq=180.0, dt=1.5, BAT=20, Tg=10, H=0.45, ve=0.3, Fp=0.01, fa=0.2, Ta=2, khe=0.003, Th=1200, field_strength=3.0, agent='gadoxetate', R10a=0.614, R10=1.3297872340425532, S0b=100, S0=150, sequence='SS', TR=0.005, FA=15, TC=0.5, CNR=inf, dt_sim=0.1)[source]#

Synthetic data for liver tissue.

Parameters:

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

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

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

  • Tg (float, optional) – Gut mean transit time. Defaults to 10 sec.

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

  • ve (float, optional) – Extracellular volume fraction. Defaults to 0.3.

  • Fp (float, optional) – Plasma flow in mL/sec/mL. Defaults to 0.01.

  • fa (float, optional) – Arterial flow fraction. Defaults to 0.2.

  • Ta (float, optional) – Arterial mean transit time. Defaults to 2 sec.

  • khe (float, optional) – Hepatocellular uptake rate. Defaults to 0.003.

  • Th (float, optional) – Hepatocyte mean transit time. Defaults to 20 mins.

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

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

  • 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.

  • S0b (int, optional) – Signal scaling factor for blood (arbitrary units). Defaults to 100.

  • S0 (int, optional) – Signal scaling factor for tissue (arbitrary units). Defaults to 150.

  • sequence (str, optional) – Scanning sequences, either steady-state (‘SS’) or Steady-state with inflow effects (‘SSI’).

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

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

  • TC (float, optional) – Aortic inflow time for SSI sequence model. 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: array of time points.

  • aif: array of AIF signals.

  • vif: array of VIF signals.

  • roi: array of ROI signals.

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

Return type:

tuple