This is an old revision of the document!
fScan Reference Manual, Chapter 2 (CmdLineOptions): roi
ROI's can be added to the current data set by explicitly specifying the ROI type, location, and size. The list above shows the various ROI types and how they are specified. The meaning of he arguments is:
The RX type of ROI (when implemented) creates a slice prescription ROI on the current data set based on slice orientation in REFIMAGE.
The CLUSTER type ROI assumes that the current data set is an ROI mask image (in which regions are defined by voxels with the same intensity value). The CLUSTER command uses the input mask image to create an ROI list (name=NAME) of CLUSTER type ROIs where each cluster is defined by its mask value. For each CLUSTER, the center-of-mass location and the radius along the 3 principal axes are stored. By default, the new ROI list is attached to the input mask data set.
The ROI command can also be used to manipulate existing ROI's.
-roi CLUSTER refimage flag name
Assumes roi mask image as input. Create an ROI list (name=NAME) of clusters where each cluster is defined by its mask value. For each cluster, store center-of-mass and radius along principal axes. If REFIMAGE, find peak intensity value and voxel location. By default, ROI list is attached to input mask images. FLAG: (no values yet) NAME: name of ROI list. If omitted, list is linked to input mask images.
-roi MERGE refimage flag name minvalley minsize mindist
The MERGE command assumes that the current image is an ROI mask.
MERGE edits the ROI list. Merge adjacent clusters if:
1) distance bet peaks < MINDIST 2) stat value in valley between peaks is within MINVALLEY percent of lower peak 3) smaller cluster contains fewer than MINSIZE voxels FLAG: 2 - do not modify input mask image values when editting ROI list (i.e. if merging ROI clusters, change merged mask values) NAME: name of ROI list. If omitted, list is linked to input mask images. MINVALLEY: (default= 60% of lower peak maximum) MINSIZE: (default= 5 voxels) MINDIST: (default= 40 mm)
-roi STATS refimage flag showflag mode name value nlevels level0 dlevel
Calulate stats in input data by ROI
REFIMAGE - dataset to use as ROI mask(s) FLAG - stats options (select one value 0-7; add other values) 0 - default stats (3 = Mean,Count,StDev) 1 - include mean 2 - include counts, and mean 3 - include stdev, and above 4 - include range, and above 5 - include ctr loc, and above 6 - include peak val&loc, and above 7 - include intensity weighted ctr loc, and above 010 - mean time course 020 - calculate laterality index if available 040 - calculate stats omitting zero values SHOWFLAG - Report generation flags 1 - tab-separated columns in text output (default is space-separated) 2 - comma-separated columns in text output 020 - include ROI's with only zero values in report 0100 - save as XML text file 0200 - save as tab-delimited text file 0400 - plot ref time series 01000 - save as ref time series 02000 - generate AMPLE statistics 04000 - ignore thresholds (default: use threshold if active) 010000 - Watch flag (?) MODE 0 - default: 1 if active ROI, 2 if this has glossary, 3 if prev has glossary, 4 if prev is atlas 1 - block ROI's (active or all) 2 - mask values in current data 3 - mask values in prev data set 4 - atlas areas 8 - threshold (can combine with 1-4) NAME - save stats in file NAME, if specified VAL: if > 0, only calculate for this mask value NLVLS: # threshold levels to calc separately (def=1)
If input is a Surface:
FLAG 1 - surface area of AREA ROI or path length of contour ROI
See Also:
fScan Home,
fScan Manual,
CmdLineOptions,
Manual Help