-------------------------------------------
entry variable: $upstatpatt -- upsampled stats file
-------------------------------------------
default: */scandir1/scan1_r+orig.BRIK

The "valup:" entry shows the name of the current
registered and upsampled-to-structural-resolution
3D statistical amplitude (val) overlay file.
This file will usually not exist initially,
unless the displayed image (upsampled for display
from a native-resolution stats input) has been
previously saved using "W".

Session directory can be abbreviated as an
asterisk (*).  Absolute name OK, too.  Relative
name appended to session.

Examples:

  pol1-vreg_r+orig.BRIK
  pol1-vreg_i+orig.BRIK

Read and write 256x256x256 AFNI float BRIK
format (BRICK_TYPE=3) only.

Contains real-valued activations, complex-valued
activations, or a statistical mask, all of which
have been upsampled to 1x1x1mm (resolution of
structural underlay) and possibly 3D-smoothed.

If the file infix immediately before +orig.BRIK
is either "_r" or "_x", and the data is
complex-valued as determined by "cpx" being
ticked ($complexvalflag=1), an attempt will also
be made to also read (or write) the corresponding
"_i" or "_y" BRIK file.

Since BRIKs must end in "+{orig,acpc,mtlrc}.BRIK"
to be seen by AFNI, "+orig.BRIK" is always
appended when constructing the initial value of
the $upstatpatt filename from the native
resolution (un-upsampled) 3D input stat
filenames.  For complex data with an infix, this
can result in a harmless duplication of "+orig":

Native (EPI) resolution input file names like:

  eccletdilim2sm-1-vreg+orig_r_%03d.bfloat

generate initial upsampled stat ($upstatpatt)
names like:

  eccletdilim2sm-1-vreg+orig_r+orig.BRIK
