#### extract 3D Stats + Timecourses ####
-------------------------------------------
funct: "Dump Stat+TimeSeries at Label Vtxs (left-click-S)"
  set label <outfile>
  write_label_timecourses_stats 2                ;# stat+raw
-------------------------------------------
funct: "Dump Stat+TimeSer at Annot RGB (middle-click-S)"
  [single output auto-named w/region-name]
  write_annotcol_timecourses_stats r g b 2   ;# stat+raw
-------------------------------------------
funct: "Dump Stat+TimeSer All Annots (shift-middle-clk-S)"
  [multiple outputs auto-named w/region-names]
  write_annotcols_timecourses_stats 2         ;# stat+raw
-------------------------------------------

###### extract 3D Stats only ######
-------------------------------------------
funct: "Dump Just Stat at Label Vtxs (ctrl-left-click-S)"
  set label <outfile>
  write_label_timecourses_stats 1;               ;# stat only
-------------------------------------------
funct: "Dump Just Stat at Annot RGB (ctrl-middle-click-S)"
  [single output auto-named w/region-name]
  write_annotcol_timecourses_stats r g b 1   ;# stat only
-------------------------------------------
funct: "Dump Just Stat All Annots (shift-ctrl-middle-clk-S)"
funct (shift-ctrl-middle-click): write stat each annot region
  [multiple outputs auto-named w/region-names]
  write_annotcols_timecourses_stats 1         ;#stat only
-------------------------------------------


The "S" button on the "label:" entry line
performs the same operation as the "T" button
(dump ASCII 3D data for a set of surface
vertices) but also includes samples of 3D volume
stats file (possibly complex) in the ASCII output
file (immediately before the timecourse).  If
ctrl is pressed in addition, then *only* stats
are dumped (no timecourses).

As with the "T" button, the set (or sets) of
surface vertices whose timecourses are dumped is
determined by:

 left-click:               all vertices in current label file
 middle-click:          annotation vtxs from region w/curr col
 shift-middle-click:   all regions in current annotation

In the second case, first load a color by
clicking a region in the MGH annotation (colors
load to the entries to the right of the "MESH"
button; region names will be visible in the csurf
log).

See the R-click help for "T" for details.
Left-click "label:" to get a pop-up for
interactively controlling the norm search
parameters.

As with the "T" button, this requires that the
option, -rawdata, has been given to tksurfer to
specify the rawdata file.

In addition, the 3D volume stats file must be
loaded with -real3d (and optionally -imag3d and
-mask3d), or interactively loaded by first
clicking "val:" to change it to "val3d:", and
then clicking the "R" button to read the 3D
volume(s).

It is not necessary to click the paint button,
"PAINT" (though this can be done to view the 3D
stats volume on the surface).

Args for tksurfer:

  -regdat <registerdatfile>
  -rawdata <rawdata>+orig.BRIK
  -real3d <stem[_r]{+orig.BRIK,_%03d.bfloat}>
  -imag3d <stem_i{+orig.BRIK,_%03d.bfloat}>
  -mask3d <stem_s{+orig.BRIK,_%03d.bfloat}>

As with the timecourse button, "T", for label
files, the two extracted ASCII output files (for
MGH 'dot' style or UCSD/UCL 'dash' style label
files) are named as follows (first suffix has
comma; "stat,raw"):

  rh.MT.label  -> rh.MT.stat,raw, rh.MT.xyz
  rh-MT.label  -> rh.MT.stat,raw, rh.MT.xyz

and for extractions using an MGH annotation, the
file names will use the structure name in the
annotation file as an infix:

  rh.region_S_central.raw
  rh.region_S_central.xyz

