AFNI program: fat_proc_imit2w_from_t1w

Output of -help


-------------------------------------------------------------------------

  Some basic processing of T1w anatomical images, particularly for
  preparation in using as a reference structural in TORTOISE -> makes
  an imitation T2w-contrast image, in terms of relative tissue
  contrast.  Make sure to verify all results visually!

  This does: unifizing of brightness, anisosmoothing, some skull
  stripping, and also generates an imitation T2w-contrast image
  through **very** simple means.  The output T2w volume is *not* for
  quantitative use, but for registrative purposes.

  Some automatic QC images are generated now, as well.  Montages of
  axial, sagittal and coronal views of the final T2w volume are saved
  by default in the same location as the output volumes.

  *NB: if you use a volume made this way as a reference in TORTOISE,
  then at least for ~adult-human-like (imitation) t2w volumes, at
  present it seems like you should use the following option when:
  running DR_BUDDI:  --enforce_deformation_antisymmetry 1.
  This seems to improve registration.


  REQUIRES: AFNI.

  Ver. 2.31 (PA Taylor, Sep 27, 2021)

  For use, example images, and citation, see (esp. Appendix A):
     Taylor PA, Alhamud A, van der Kouwe AJ, Saleh MG, Laughton B,
     Meintjes EM.  Assessing the performance of different DTI motion
     correction strategies in the presence of EPI distortion
     correction.  Hum Brain Mapp (in press).

-------------------------------------------------------------------------

  RUNNING:

  This script has one required argument ('-inset ...'), and the rest are
    optional:

    fat_proc_imit2w_from_t1w  \
        -inset  T1_FILE                       \
        -prefix PPP                           \
        {-workdir WWW}                        \
        {-mask    MASK}                       \
        {-ss_blur_fwhm BBB}                   \
        {-no_clean}                           \
        {-no_qc_view}                         \
        {-qc_prefix QCP}

  where: 
  -inset  T1_FILE  :is the full name of the input T1w volume;

  -prefix  PPP     :output prefix for files and snapshots (required).

  -mask   MASK     :an optional input of a pre-skullstripped T1_FILE
                    (this can be either a mask or a skullstripped volume).
                    This can be useful if the default skullstripping
                    options in this script ain't getting the job done
                    and other ones have to be done (skullstripping is
                    probably the slowest part of this set of steps).

 -ss_blur_fwhm BBB :optional, can add in blurring during the 3dSkullStrip
                    part of this program, in units of mm (default FWHM: 2).

  -workdir WWW     :specify a working directory, which can be removed;
                    (default name = '__WORKING_imit2w_from_t1w')

  -no_qc_view      :turn off the automatic creation of QC montages (which
                    are produced by default).

  -qc_prefix QCP   :change the prefix of the QC images (default: use the
                    prefix of the volumes).

  -no_clean        :is an optional switch to NOT remove working directory
                    '__WORKING_imit2w_from_t1w'; (default: remove working dir).

 ------------------------------------------------------------------------

  OUTPUTS:

    PREFIX.nii.gz         :a volume with T2w-like tissue contrast made
                           from a T1w one; the outside of the brain
                           has scaled skull and noise, for having a
                           non-zero SNR estimation.
    PREFIX_orig.nii.gz    :a somewhat cleaned/processed version of the
                           input T1w volume; it also has a scaled skull 
                           and noise outside the brain.
    PREFIX_orig_ss.nii.gz :a skull-stripped version of PREFIX_t1w.nii.gz.

    PREFIX_qc*
                          :QC images of the skull-stripped T1w volume
                           and of the final imitation-T2w volume.

-------------------------------------------------------------------------

  EXAMPLE:
    
    fat_proc_imit2w_from_t1w   \
        -inset T1.nii.gz               \
        -prefix imit2w
  or

    fat_proc_imit2w_from_t1w   \
        -inset T1.nii.gz               \
        -mask  mask_WB.nii.gz          \
        -prefix imit2w
        -no_clean

-------------------------------------------------------------------------


This page auto-generated on Thu Oct 31 09:44:07 PM EDT 2024