HELP FILE FOR AP-QC
afni_proc.py's single subject QC report form

OVERVIEW
QC organization
    The quality control (QC) is organized into thematic blocks to
    check, such as original data acquisition, different alignments,
    motion, regression modeling, and more. At the top of the QC page,
    there is a navigation bar with a label for each QC block (vorig,
    ve2a, etc.) that functions as a button to the top of that section.

Rating
    Beneath each section label is a(n initially empty) QC button,
    which users can click to set a rating for that QC block and for
    the overall subject rating ("FINAL"). Clicking on the QC button
    toggles its state through good (+), bad (X) or other (?, which may
    include 'ugly', or just a hint to revisit later).  Users can also
    use convenient 'filler buttons' at the right (A+, Ax, etc.), when
    the ratings are constant/uniform-- one hopes for 'all good'
    processing, but who knows...

Commenting
    Additionally, users can ctrl+click on the QC button to enter a
    comment for that block.  For example, they can write why a rating
    was good or bad, or what question they have led them to rate it as
    'other'.

Saving
    Clicking SAVE will let the user save the QC ratings+comments on
    their computer for later use, such as inclusion/exclusion criteria
    for the subject in group analysis.  (NB: This action is treated
    the same as downloading a file from online, and is subject to
    standard limitations on simplicity due to browser security
    settings.)

See also
    The online web tutorial:
    https://afni.nimh.nih.gov/pub/dist/doc/htmldoc/tutorials/apqc_html/main_toc.html
    It's more verbose and pictorial, if that's useful.

DEFINITIONS
QC block 
    One thematic section of the QC form (original data, alignment
    step, etc.).  Each block has a label in the navigation bar (vorig,
    ve2a, etc.)-- click on the label to jump to that block. Click on
    the button below the label to provide a rating for that block.

QC button
    Below each QC block label in the navigation bar is a button
    (initially empty after running afni_proc.py). The user can click
    on it to toggle its state to one of three ratings (good, +; bad,
    X; other, ?), as well as to enter a comment for that QC block (via
    ctrl+click).

'FINAL' 
    Label for the QC button to hold the user's overall/final
    evaluation of the subject's data and processing. (Clicking on this
    label does nothing.)

filler button 
    |A+|, |Ax|, |A?|-- located in the upper right corner of the
    navigation menu.  These can be used to provide uniform ratings
    across the QC buttons (click to fill empty buttons, double-click
    to fill *all* buttons, regardless of state).  
    |clr|-- double-clicking on this will empty all ratings+comments
    from the QC buttons.

'SAVE'
    Write the ratings+comments to disk.  This action is done through
    the browser, and is subject to the browser settings; probably
    users should not have the browser set to automatically download
    all files to the same location, for example.

'HELP'
    Button : well, how did you get here??

'BC', 'AC'
    When using the 'pythonic' HTML style, 1D-plotting (like motion
    enorm plots) also produces boxplots to summarize values.  When
    censoring has been applied, by default there will be two boxplots
    made: one of values 'before censoring' (BC), and one of values
    'after censoring' (AC).  Those labels are affixed in order to the
    titles of the boxplots.


SET BUTTON RATING

To record an evaluation, click the button below any section label, and
toggle through:
    + : good,
    X : bad,
    ? : other (or 'revisit').

For speed, you can click 'filler button' |A+| once to fill all *empty*
buttons with +, or doubly to fill *all* buttons with +.  |Ax| behaves
the same for X, and |A?| for ?.

Double-click |clr| to clear all rating and comment values.

Pro-tip: if data are mostly all in a single state like good or bad,
just use filler buttons to save yourself click time, and then just
click any individual buttons that are different.  

COMMENT

Use ctrl+click on a QC button to open (or close) a comment window.  

Save a comment with the green (left) button, or hit Enter at any point.
Remove a comment with the pink (right) button, or hit Esc at any point.

Any QC button with a comment gets a pair of quotes added, like ''+''.
Comments are independent of rating, but adding a comment to an empty
button changes its rating to ''?'' (which can be altered further from
there).

SAVE FORM
Click on the 'SAVE' button.  

Unfortunately, the file will not be directly saved by this, due to
security settings on most web-browsers, and the user will be prompted
to save the file as if downloading from the Web.

KEYBOARD NAVIGATION

Use Tab to navigate the QC menu mirroring all above functionality.

Hit Tab to move through the menu.  Hit Enter on a section label to
scroll the page there.

On QC buttons hit Enter to toggle through the rating list.  Use
ctrl+Enter to open comments; as above, use Enter or Esc to keep or
erase, respectively.

On the filler buttons |A+|, |Ax| and |A?|, use Enter to fill empty
QC buttons and ctrl+Enter to fill *all* buttons. 
On |clr|, ctrl+Enter clears all rating and comment values.  

QC BLOCKS

vorig
    Volumetric mages of data (EPI and anat) in original/native space.
    *Coming soon*.
    
ve2a
    Volumetric images of the alignment of the subject's anat
    (underlay/grayscale) and EPI (overlay/hot color edges) volumes. Likely
    these will be shown in the template space, if using the tlrc block.
    
va2t
    Volumetric images of the alignment of the standard space template
    (underlay/grayscale) and subject's anat (overlay/hot color edges)
    volumes.
    
vstat
    Volumetric images of (full) F-stat of an overall regression
    model. These images are only created for task data sets, i.e., where
    GLTs or stimuli are specified (so not for resting state data).
    
mot
    Summary of motion and outlier information, which may each/both be
    used as censoring criteria.
    
    The 6 rigid body motion parameters (3 rotation + 3 translation) are
    combined into a single quantity: the Euclidean norm (enorm), which has
    approx. units of 'mm'.  Large changes in the enorm time series show
    moments of subject motion.
    
    Separate runs are shown with the background alternating between white
    and light gray.
    
    Boxplots summarize parameter values, both before censoring (BC) and
    after censoring (AC).
    
regr
    When processing with stimulus time series, both individual and
    combined stimulus plots are generated (with any censoring also shown).
    
    The degrees of freedom (DF) summary is also provided, so one can check
    if too many get used up during processing (careful with bandpassing!).
    
    And a grayplot of residuals is provided.
    
warns
    Several AFNI programs carry out consistency checks while
    processing (e.g., pre-steady state check, regression matrix corr
    warnings, left-right flip checks).  Warnings are conglomerated here.
    
    Each warning has one of the following levels:
         none undecided mild medium severe
    
    The warning level is written, with color coding, at the top of each
    warning's text box.  The QC block label 'warns' at the top of the page
    is also colored according to the maximum warning level present.  
    
radcor
    @radial_correlate plots (per run, per block). These can show
    scanner coil artifacts, as well as large subject motion; both factors
    can lead to large areas of very high correlation, which would be
    highlighted here.  
    
qsumm
    This is the output of @ss_review_basic, which contains a loooot of
    useful information about your single subject processing.