Constants

The following constants are hardcoded into FSL-MRS and are used in the quantisation module.

Water to tetramethylsilane (TMS) chemical shift

H2O_PPM_TO_TMS     = 4.65

Gyromagnetic ratio of proton:

H1_gamma           = 42.576     # MHz/tesla

Concentration scaling parameters

Tissue water density [0]:

TISSUE_WATER_DENSITY = {'GM':0.78,'WM':0.65,'CSF':0.97}

Molecular mass of water:

H2O_MOLECULAR_MASS = 18.01528   # g/mol

Molality of pure water:

H2O_MOLALITY = 55.51E3    # mmol/kg

Number of protons in water:

H2O_PROTONS = 2

The integrated water signal is referenced to a single reference basis. There are three defaults defined in FSL-MRS, and each are tried in the order listed here. Each possible reference is equivalent to a predetermined number of protons and has associated integration limits. There are:

WATER_SCALING_METAB = ['Cr', 'PCr', 'NAA']
WATER_SCALING_METAB_PROTONS = [5, 5, 3]
WATER_SCALING_DEFAULT_LIMITS = [(2, 5), (2, 5), (1.8, 2.2)]

Relaxation parameters

Values are derived from a survey of the literature. References listed below. Values for metabolites are derived from an average of NAA, Cr and Cho peaks.

T1 (all values in seconds)

T2 (all values in ms)

Code definitions:

STANDARD_T1 = {
'1.5T': {'H2O_WM': 0.630,  # Ref: 16
         'H2O_GM': 1.185,  # Ref: 16
         'H2O_CSF': 3.90,  # Ref: 17
         'METAB': 1.238},  # Ref: 18
'3T': {'H2O_WM': 0.97,  # Ref: 1-6
       'H2O_GM': 1.50,  # Ref: 1-6
       'H2O_CSF': 4.47,  # Ref: 4
       'METAB': 1.29},  # Ref: 2, 7-9
'7T': {'H2O_WM': 1.21,  # Ref: 1-6
       'H2O_GM': 2.05,  # Ref: 1-6
       'H2O_CSF': 4.43,  # Ref: 4
       'METAB': 1.43}}  # Ref: 2, 7-9

STANDARD_T2 = {
    '1.5T': {'H2O_WM': 0.080,  # Ref: 19
            'H2O_GM': 0.083,  # Ref: 19
            'H2O_CSF': 2.000,  # Approximate
            'METAB': 0.279},  # Ref: 20
    '3T': {'H2O_WM': 0.073,  # Ref: 1,3,10-11
        'H2O_GM': 0.088,  # Ref: 1,3,10-11
        'H2O_CSF': 2.030,  # Ref: 12
        'METAB': 0.194},  # Ref: 7-9,13-15
    '7T': {'H2O_WM': 0.055,  # Ref: 1,3,10-11
        'H2O_GM': 0.050,  # Ref: 1,3,10-11
        'H2O_CSF': 1.050,  # Ref: 12
        'METAB': 0.131}}  # Ref: 7-9,13-15
References