-------------------------------------------
entry variable: $statpatt -- 3D stats file (real)
-------------------------------------------
default: */scandir1/scan1+orig.BRIK

The "val3d:" entry shows the current 3D volume
stat file (usu. not loaded at startup).  To load
a 3D file (usu. AFNI BRIK), select one from the
"val3d:" dropdown and click "R" (auto-detects
complex-valued pairs).

Defines a 3D volume stats file (input to PAINT)
that can be read into a 3D stats buffer to that
it can be interactively 'painted' (sampled onto
the surface) in order to view the data.

The session directory (leading part of the full
path up to the "image" subdirectory) can be
abbreviated as an asterisk (*).  Absolute name is
OK, too.

Examples:

 */scandir1/pol1_r+orig.BRIK
 */scandir1/pol1_i+orig.BRIK

 */scandir1/pol1_r_%03d.bfloat
 */scandir1/pol1_i_%03d.bfloat

The two formats read are: (1) an AFNI float BRIK,
and, (2) a set of slice-by-slice .bfloat files.

In the first AFNI case, there should be a
correspondingly name .HEAD file present.  The
.HEAD file should have BRICK_TYPE => 3 (float
data) and ORIENT_SPECIFIC => 0 4 3 (standard
transverse EPI slice data order).

In the second bfloat case, the series of .bfloat
files should have correspondingly named .hdr
files, each of which should consist of one ASCII
line:

  y  x  t  0

A printf-style pattern is used to match a set of
files, but a single file can also be selected
from the dropdown -- for example, the third
zero-based bfloat file:

 */scandir1/pol1_r_002.bfloat

and the printf pattern will automatically be
substituted when the file set is read.
