User Tools

Site Tools


jvs:fscan:manual:chapter2:watch

fScan Reference Manual, Chapter 2 (CmdLineOptions): watch

Watch -- Monitor the progress of an analysis at regular intervals

usage:
-watch [progress] FREQ FLAG
-watch ample FLAG NAME TOP MARGIN
-watch count NCURVES DTHRESH THRESH1 MINCOUNT
-watch roi [ROIDATASET] FLAG THRESHOLD
-watch roc TRUEDATA TRUESCALE MINSTAT DSTAT NSTAT MINTRUE DTRUE NTRUE MAXFALSEPCT
-watch output IOCHANNEL FLAG [VARB]
-watch input IOCHANNEL FLAG VARB
-watch series
-watch wait

Note: WATCH arguments shown above in upper case are user-defined values; lower case words have special meaning and should be entered as shown.

The WATCH command allows you to watch the progress of an analysis by sampling the results at regular intervals. You should specify WATCH parameters before starting the associated analysis. This will cause the analysis to stop at the specified time points (FREQ), perform the monitoring task(s), and then continue.

The WATCH command should be used in conjunction with some statistical processing command, such as MEAN, TTEST, CORRELATE, PCTSIGNAL, ACCUMULATE, or MOVIE. The statistical command controls what processing will be done; the WATCH command specifies when the results will be calculated and how they will be displayed.

The first argument indicates what type of WATCH command you want (if the first argument is a number, PROGRESS command type is assumed). You can use multiple types of WATCH commands in sequence if you want to combine options. The command types are:

  • progress - specify how often to pause the statistical analysis. The frequency is specified in images (i.e., time/tr). If frequency is ommitted and the analysis is based on block timing (i.e., a MOVIE cycle or a blocked reference task), the frequency will be one full image cycle.
  • ample - generate a normalized AMPLE map each time a new statistical map is computed.
  • count - count the number of voxels at different threshold levels
  • roi - generate separate mean statistics for each region of interest (default ROI is all voxels)
  • roc - compare voxels detected to voxel counts in “true activation” reference data set
  • output - send summary statistics out IOCHANNEL at each WATCH cycle
  • input - read values from IOCHANNEL and store in VARB
  • wait - wait for user input (any key press) at each WATCH processing step (same as -wait 4)

See Also:
WAIT, TTEST, CORRELATE, MOVIE, MEAN, MEANSTDEV, FFT, AMPLE

fScan Home, fScan Manual, CmdLineOptions, Manual Help

jvs/fscan/manual/chapter2/watch.txt · Last modified: 2023/02/23 18:43 (external edit)