:orphan:

.. _ahelp_gtkyd_check:

***********
gtkyd_check
***********

.. contents:: :local:


| 

    
    This program is for Getting To Know Your Data (GTKYD). Provide a list
    of datasets, and this program will check their header (and possibly a
    few data) properties. Properties are checked with 3dinfo, nifti_tool
    and 3dBrickStat. 
    
    This program creates the following useful outputs:
    
    + A compiled spreadsheet-like table file, for reference, with 1 row
      per input dataset and one column per measured property. This is
      actually made using gen_ss_review_table.py. 
      (name: OUT.xls)
    
    + For each item checked, there will also be a detailed report file (N
      lines of data for N input datasets)
      (name: OUT/rep_gtkyd_detail_*.dat)
    
    + For each item checked, there will be a "uniqueness" report file,
      which will have 1 line of data for each unique value present across
      all input datasets. So, if there is only 1 line of data, then that
      property is consistent across all dsets; otherwise, there is some
      variability in it.
      (name: OUT/rep_gtkyd_unique_*.dat)
    
    + For each input dataset, a colon-separated dictionary of basic
      properties. These can be further queried with gen_ss_review_table.py.
      (name: OUT/dset_*.txt)
    
    
    ver  = 1.1
    auth = PA Taylor (SSCC, NIMH, NIH, USA), but no doubt also including 
           the valuable insights of RC Reynolds and DR Glen
    

Overview
========

    

Usage
=====

.. code-block:: none

    
    -infiles FILE1 [FILE2 FILE3 ...]
                   :(req) name of one or more file to input
    
    -outdir ODIR   :(req)name of output "report directory", for more the 
                    reports of details and uniqueness of each property.
    
    -do_minmax     :include dataset min and max value info, which can be 
                    slow (uses '3dBrickStat -slow ...' to calculate it 
                    afresh)
    
    -help, -h      :display program help file
    
    -echo          :run very verbosely, by echoing each part of script  
                    before executing it
    
    -ver           :display program version number
    

Examples
========

.. code-block:: none

    
    1) Basic example, running on a set of EPI:
        gtkyd                                        \
            -infiles  group_study/*task*.nii.gz      \
            -outdir   group_summary
    
    2) Include (possibly slow) min/max info, and check anatomical dsets:
        gtkyd_check                                          \
            -infiles    group_study2/*T1w*.nii.gz *T1w*HEAD  \
            -do_minmax                                       \
            -outdir     group_summary2