dcmri.params_tissue#

dcmri.params_tissue(kinetics='2CX', water_exchange='RR') → list[source]#

Parameters characterizing a 2-site exchange tissue. For more detail see Exchange tissues.

Parameters:

kinetics (str, optional) – Tracer-kinetic regime. Possible values are ‘2CX’, ‘2CU’, ‘HF’, ‘HFU’, ‘NX’, ‘FX’, ‘WV’, ‘U’. Defaults to ‘2CX’.
water_exchange (str, optional) – Water exchange regime. Any combination of two of the letters ‘F’, ‘N’, ‘R’ is allowed. Defaults to ‘RR’.

Returns:

tissue parameters

Return type:

list

Raises:

ValueError – if the configuration is not recognized.

Example

Print the parameters of a HFU tissue with restricted water exchange:

>>> import dcmri as dc

>>> dc.params_tissue('HFU', 'RR')
['PSe', 'PSc', 'H', 'vb', 'vi', 'PS']

Notes

Table Parameters by configuration list the water compartments and free parameters for all configurations. Regimes without water exchange across one or both of the barriers are not listed explicitly (FN, NF, FR, NR and NN). They differ from restricted water exchange only in the sense that the respective water permeabilities PSe and/or PSc are zero.

**Parameters by configuration**#
Water exchange	Indicator exchange	Water compartments	Free parameters
FF
FF	2CX	vb + vi + vc	H, vb, vi, Fb, PS
FF	2CU	vb + vi + vc	H, vb, Fb, PS
FF	HF	vb + vi + vc	H, vb, vi, PS
FF	HFU	vb + vi + vc	H, vb, PS
FF	FX	vb + vi + vc	H, ve, Fb
FF	NX	vb + vi + vc	vb, Fb
FF	U	vb + vi + vc	Fb
FF	WV	vb + vi + vc	H, vi, Ktrans
RR
RR	2CX	vb, vi, vc	PSe, PSc, H, vb, vi, Fb, PS
RR	2CU	vb, vi, vc	PSe, PSc, H, vb, vi, Fb, PS
RR	HF	vb, vi, vc	PSe, PSc, H, vb, vi, PS
RR	HFU	vb, vi, vc	PSe, PSc, H, vb, vi, PS
RR	FX	vb, vi, vc	PSe, PSc, H, vb, vi, Fb
RR	NX	vb, vi, vc	PSe, vb, vi, Fb
RR	U	vb, vi, vc	PSe, vb, vi, Fb
RR	WV	vi, vi+vc	PSc, H, vi, Ktrans
RF
RF	2CX	vb, vi+vc	PSe, H, vb, vi, Fb, PS
RF	2CU	vb, vi+vc	PSe, H, vb, Fb, PS
RF	HF	vb, vi+vc	PSe, H, vb, vi, PS
RF	HFU	vb, vi+vc	PSe, H, vb, PS
RF	FX	vb, vi+vc	PSe, H, vb, vi, Fb
RF	NX	vb, vi+vc	PSe, vb, Fb
RF	U	vb, vi+vc	PSe, vb, Fb
RF	WV	vi+vc	H, vi, Ktrans
FR
FR	2CX	vb+vi, vc	PSc, H, vb, vi, Fb, PS
FR	2CU	vb+vi, vc	PSc, H, vb, vi, Fb, PS
FR	HF	vb+vi, vc	PSc, H, vb, vi, PS
FR	HFU	vb+vi, vc	PSc, H, vb, vi, PS
FR	FX	vb+vi, vc	PSc, H, vb, vi, Fb
FR	NX	vb+vi, vc	PSc, vb, vi, Fb
FR	U	vb+vi, vc	PSc, vc, Fb
FR	WV	vi, vc	PSc, H, vi, Ktrans