DixonReconstruct
  • Related Guides
    • DixonTools
    • Related Guides
      • DixonTools

DixonReconstruct[{real,imag},echo]

reconstructs Dixon data with initial guess b0 = 0 and T2star = 0.

DixonReconstruct[{real,imag},echo,{b0}]

reconstructs Dixon data with initial guess T2star = 0.

DixonReconstruct[{real,imag},echo,{b0,t2}]

reconstructs Dixon data with t2star and B0.

DixonReconstruct[{real,imag},echo,{b0,t2,ph0}]

reconstructs Dixon data with initial phase.

DixonReconstruct[{real,imag},echo,{b0,t2,ph0,phb}]

reconstructs Dixon data with bipolar phase. Echo times echo are in s, the initial b0 in Hz, t2 in s and the phases ph0 and phb in cycles. Output is {{watFr, fatFr}, {watSig, fatSig, ...}, {inphase, outphase}, {{b0, phb, ph0, phbt}, {t2, r2}}, iterations, residuals}. The phase maps are only those selected with DixonPhases, if R2 is fitted the T2 and R2 maps are given separately. If a fat model is used the signals are followed by the fitted fat model parameters (e.g. double bonds). The fractions are between 0 and 1 (see DixonClipFraction), the B0 field map is in Hz, the T2star map in s and R2star in 1/s.

DixonReconstruct[]

is based on DOI: 10.1002/mrm.20624 and 10.1002/mrm.21737 (10.1002/nbm.3766).

Details and Options
Details and Options Details and Options
Related Guides
QMRITOOLS SYMBOL
  • Related Guides
    • DixonTools
    • Related Guides
      • DixonTools
QMRITools`
QMRITools`

DixonReconstruct

DixonReconstruct[{real,imag},echo]

reconstructs Dixon data with initial guess b0 = 0 and T2star = 0.

DixonReconstruct[{real,imag},echo,{b0}]

reconstructs Dixon data with initial guess T2star = 0.

DixonReconstruct[{real,imag},echo,{b0,t2}]

reconstructs Dixon data with t2star and B0.

DixonReconstruct[{real,imag},echo,{b0,t2,ph0}]

reconstructs Dixon data with initial phase.

DixonReconstruct[{real,imag},echo,{b0,t2,ph0,phb}]

reconstructs Dixon data with bipolar phase. Echo times echo are in s, the initial b0 in Hz, t2 in s and the phases ph0 and phb in cycles. Output is {{watFr, fatFr}, {watSig, fatSig, ...}, {inphase, outphase}, {{b0, phb, ph0, phbt}, {t2, r2}}, iterations, residuals}. The phase maps are only those selected with DixonPhases, if R2 is fitted the T2 and R2 maps are given separately. If a fat model is used the signals are followed by the fitted fat model parameters (e.g. double bonds). The fractions are between 0 and 1 (see DixonClipFraction), the B0 field map is in Hz, the T2star map in s and R2star in 1/s.

DixonReconstruct[]

is based on DOI: 10.1002/mrm.20624 and 10.1002/mrm.21737 (10.1002/nbm.3766).

Details and Options

  • The following options can be given:
  • DixonPrecessions1DixonPrecessions is an option for DixonReconstruct. Defines the rotation of the signal {-1,1} default is 1.
    DixonFieldStrength3DixonFieldStrength is an option for DixonReconstruct. Defines the fieldstrengths in Tesla on which the data was acquired.
    DixonNucleus"1H"DixonNucleus is an option for DixonReconstruct. Defines the nucleus for which the reconstruction is performed.
    DixonFrequencies{{0.}, {-3.81, -3.4, -3.12, -2.67, -2.45, -1.94, -0.63, -0.4, 0.52, 0.62}}DixonFrequencies is an option for DixonReconstruct. Defines the frequencies in ppm of the fat peaks being used.
    DixonAmplitudes{{1}, {0.089, 0.577, 0.059, 0.093, 0.059, 0.013, 0.02, 0.02, 0.01, 0.059}}DixonAmplitudes is an option for DixonReconstruct. Defines the relative amplitudes of the fat peaks being used. Can also be a fat model string, "Fixed", "Full", "FitCL", "FitDB", "FitIDB", "CallCL", "CallDB" or "CallIDB", see GenerateAmps.
    DixonRelaxivity{{35}, {130, 135, 85, 95, 100, 90, 100, 100, 85, 85}}DixonRelaxivity is an option for DixonReconstruct. Defines the T2 relaxation times in ms of water and the fat peaks being used. Is only used if DixonFixT2 is set to True.
    DixonIterations10DixonIterations is an option for DixonReconstruct. Defines the maximum iterations the fit can use.
    DixonTolerance1DixonTolerance is an option for DixonReconstruct. Defines at which change per iteration the iterative method stops. The change is the sum of R2star (1/s) and b0 (Hz) plus 100 times the phases (cycles) and bipolar phase drift (Hz). Default value is 1.
    DixonMaskThreshold0.1DixonMaskThreshold is an option for DixonReconstruct. Defines at which Threshold the dixon reconstruction considers a voxel to be background noise. It is an absolute value of the first echo magnitude, default values is 0.1.
    DixonFilterInputFalseDixonFilterInput is an option for DixonReconstruct. If True the input b0 and T2star values are smoothed using the DixonFilterType filter.
    DixonFilterOutputTrueDixonFilterOutput is an option for DixonReconstruct. If True the output field maps are smoothed using the DixonFilterType filter after which the water and fat maps are recomputed.
    DixonFilterSize1DixonFilterSize is an option for DixonReconstruct. Defines the filter size in voxels with which the input and output field maps are smoothed.
    DixonFilterType"Median"DixonFilterType is an option for DixonReconstruct. FilterType can me "Median" or "Laplacian".
    DixonPhases{True, True, False, False, False}DixonPhases is an option for DixonReconstruct. It defines which phases to fit within the model. The order is {R2, B0, bipolar phase, initial phase, bipolar phase drift}.
    DixonClipFractionFalseDixonClipFraction is an option for DixonReconstruct. If set True the fractions are clipped between 0 and 1, otherwise between -0.1 and 1.1.
    DixonCorrectT1FalseDixonCorrectT1 is an option for DixonReconstruct. To perform T1 correction provide the TR and FA as a list, {TR, FA}. TR is in ms and FA in degrees.
    DixonFixT2FalseDixonFixT2 is an option for DixonReconstruct. If set to true the R2' is fitted rather then the R2*. This is done by fixing the T2 of water and each fat peak to the DixonRelaxivity values.
    DixonConstrainPhaseFalseDixonConstrainPhase is an option for DixonReconstruct. If set True everything is fitted as real values.
    MonitorCalcFalseMonitorCalc is an option for many processing functions. When true the process of the calculation is shown.
    DixonFitPhaseFalseDixonFitPhase is an option for DixonReconstruct. If set to True the phase maps are fitted using polynomial functions.
    ParallelizeTrueParallelize[expr] evaluates expr using automatic parallelization.

Related Guides

    ▪
  • DixonTools