NAME

mri_ms_fitparms

SYNOPSIS

mri_ms_fitparms [options] [vol_1] [vol_2] ... [output_dir]

DESCRIPTION

This program takes up to 500 FLASH images as input, and estimates the T1 and PD values of the data for voxel, as well as a linear transform aligning each of the images. The T1 and PD maps are written into [output_dir] together with synthetic volumes names vol?.mgz, one for each of the input volumes. All the output volumes are generated in the common (motion-corrected) space. Note that TR, TE and the flip angle are read directly from the image header. If this information is not available, it can be specified on the command line using -tr [TR in msec] -te [TE in msec] -fa [flip angle in degrees] before each volume. Use -at [xform file name] or -ait [xform file name] to specify transformation for each individual volume. Note only one for each flip-angle is enough. -at will apply the transform to the following volume to align with others.

Interpolation method. Default is trilinear, other options are nearest, cubic, sinc. You can say -foo or -interp foo. For sinc, you can say -interp sinc 3 or -interp sinc -hw 3 or -sinc 3 or -sinc -hw 3. Maybe -hw 3 should imply sinc, but right now it doesn't.

POSITIONAL ARGUMENTS

ArgumentExplanation
vol_13D FLASH flip angle 1
vol_23D FLASH flip angle 2
output_diroutput directory

REQUIRED-FLAGGED ARGUMENTS

None

OPTIONAL-FLAGGED ARGUMENTS

ArgumentExplanation
-afi, -famDesignate flip angle map to use with nominal value 60 degrees
-aitApply inverse of transform
-atSet acquisition time
-conformInterpolate volume to be isotropic 1mm^3
-correctCorrect proton density map(PD) by T2* estimates
-cubicUse cubic interpolation
-debug_slice????
-debug_voxel????
-dtSet dt ????
-faSet flip angle
-fa_scaleSet value to scale all flip angles by
-fafDesignate flip angle map to use with specified control points
-fsmoothSmooth flip angle map for X interations of soap bubble smoothing (thres=??)
-iInvert
-mSet momentum
-maxSet max T2*
-nPerform estimation/motion correction X times
-nearestUse nearest-neighbor interpolation
-nocompressDo not compress output volumes (save as .mgh)
-nosynthDisable volume synthesis
-rwrite out residuals to designated location
-sSmooth faf field with sigma=X
-scaleScale volumes by X after reading
-sincUse sinc interpolation (default window width is 6)
-tApply transform to output volumes
-teSet echo time (TE) in ms
-trSet repetition time (TR) in ms
-trilinearUse trilinear interpolation
-tukeyUse tukey bi-weight of residuals
-uthis help text
-use_brain_maskCompute a brain mask from the PD map and use it when computing registration
-wWrite out intermediate results every X iterations
-windowNot implemented(????)

OUTPUTS

OutputExplanation
T1.mgzCompressed T1 map
PD.mgzCompressed Proton Density map
vol0.mgzCompressed Synthetic volume for input [vol_1], in motion corrected space
vol0.ltaMotion correction afine information (text file)
vol1.mgzCompressed Synthetic volume for input [vol_2], in motion corrected space
vol1.ltaMotion correction afine information (text file)

EXAMPLE 1

cd subjectid/mri/flash
mri_ms_fitparms -tr 20 -te 6 -fa 5 flash5.mgh -tr 20 -te 6 -fa 30 flash30.mgh

Description: Two 3D FLASH volumes (flip angles 5 and 30 degrees), both acquired with the same TE (20ms) and TR (6ms) are used to fit T1 and PD maps and the results are written into the same directory (subjectid/mri/flash).

BUGS

None

REPORTING

Report bugs to <freesurfer@nmr.mgh.harvard.edu>