apqc_make_tcsh.py


This program creates the single subject (ss) HTML review script
'@ss_review_html', which itself generates images and text that form
the afni_proc.py quality control (APQC) HTML.

It is typically run by the afni_proc.py (AP) proc* script itself.

Options:

-uvar_json  UJ    :(req) UJ is a text file of uvars ("user variables")
                   created by gen_ss_review.py that catalogues important
                   files in the results directory, for the APQC.

-subj_dir   SD    :(req) location of AP results directory (often '.', as
                   this program is often run from within the AP results
                   directory).

-review_style RS  :(opt) the 'style' of the APQC HTML output HTML.  Allowed
                   keywords are:
                       basic, none, pythonic
                   + Using 'pythonic' is the recommended way to go: the
                   1D images are the clearest and most informative.
                   It means you need the Python module Matplotlib
                   (v>=2.2) installed, which should be a light dependency.
                   + Using 'basic' means that no Matplotlib will be
                   used, just 1dplot, and the images will be more,
                   well, basic-looking.
                   + Using 'none' means no APQC HTML is generated (boooooo).

-mot_grayplot_off :(opt) turn off the grayplot generation.  This
                   option was created for a specific case of a user who had
                   a huuuge dataset and the grayplot took annoyingly long
                   to estimate.  Not recommended to use, generally.

-vstat_list A B C ...
                  :(opt, only applicable if stim timing is used in
                   processing) provide a list of label items to specify
                   which volumes's images should appear in the vstat
                   QC block.  Each item should correspond to subbrick
                   label basename (so not including '_GLT', "#N",
                   'Tstat', 'Fstat', 'Coef', etc.) in the stats_dset.
                   'Full_Fstat' is always added/included, even if not
                   provided in this list. If not used, the program
                   uses default logic to pick up to 5 items to show.

-can_add_blur CAB :(opt) if the FMRI processing did not use blurring, then
                   the APQC HTML creation can add blurring to a couple steps
                   within the QC generation that might be easier to interpret,
                   such as the seedbased correlation maps, in the TSNR warns
                   levels of any ROI TSNR tables, and in the corr_brain map.
                   This program will check the uvars for whether blurring was
                   used automatically, to know whether it would consider adding
                   extra blur in the QC images; the TSNR warn levels will still
                   be automatically adjusted based on blurring/not.
                   These extra blurs *only* apply in the QC items, not in the
                   final data; this program will check the uvars for whether
                   blurring
                   If you don't want this program to check to add any extra
                   blur for data processed without blurring, then disable that
                   here.
                   Allowed values of CAB are: Yes or 1, No or 0.
                   (def: Yes)

-ow_mode  OM      :(opt) set overwrite mode; choices are
                   backup       -> move old QC dir to QC_<time>; make new QC dir
                   overwrite    -> purge old QC dir and make new QC/
                   shy          -> (def) make new QC dir only if one does not exist
                   See also '-bup_dir ..' for additional backup dir
                   naming.

-bup_dir  BD      :(opt) if using the '-ow_mode backup' option, then
                   you can use this opt to provide the desired name of
                   the backup QC directory (def: use QC_<time>).

-do_log           :(opt) flag to turn on making a text log of all the
                   shell commands that are run when apqc_make_tcsh.py
                   is executed; mainly for debugging purposes, if
                   necessary.

-run              :(opt) a trivial option that does nothing, but means you can
                   execute this program, rather than display the help text,
                   when using default -uvar_json and -subj_dir values (which
                   mean running this in the current dir)