This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
jvs:fscan:manual:chapter2:roi [2016/07/26 19:58] voyvodic |
jvs:fscan:manual:chapter2:roi [2023/02/23 18:43] (current) |
||
---|---|---|---|
Line 2: | Line 2: | ||
===== ROI -- Define and manipulate Regions of Interest ===== | ===== ROI -- Define and manipulate Regions of Interest ===== | ||
====usage: | ====usage: | ||
+ | [[jvs: | ||
* -roi POINT [NAME] x y z\\ | * -roi POINT [NAME] x y z\\ | ||
* -roi BLOCK [NAME] x0 y0 z0 nx ny nz\\ | * -roi BLOCK [NAME] x0 y0 z0 nx ny nz\\ | ||
Line 15: | Line 16: | ||
* -roi TEXT [NAME] textstring x0 y0 x1 y1 | * -roi TEXT [NAME] textstring x0 y0 x1 y1 | ||
* -roi MASK datasetname | * -roi MASK datasetname | ||
+ | * | ||
* -roi FILE roifile | * -roi FILE roifile | ||
* -roi RX refimage | * -roi RX refimage | ||
- | * -roi MEAN flag | + | * -roi AVERAGE |
+ | * -roi HEAD [NAME] flag | ||
+ | |||
+ | | ||
+ | | ||
+ | FLAG: 0 - default (bottom boundary set at top - (L/R distance) | ||
+ | 1 - | ||
+ | 010 - set intensity threshold at 10% of maxval (default is 15%) | ||
+ | 020 - set " | ||
+ | ... | ||
+ | 070 - set " | ||
+ | |||
+ | * -roi ALIGN [refimage flag refroi thisroi] | ||
+ | |||
+ | | ||
+ | to REFIMAGE dataset by scaling and translating THISROI to match REFROI. | ||
+ | | ||
+ | FLAG - option flag (default = 0) | ||
+ | | ||
+ | (default is active or first ROI) | ||
+ | | ||
+ | (default is active or first). | ||
+ | | ||
+ | |||
+ | [[jvs: | ||
* -roi CORREL flag refROI binsize corrROI name thresh | * -roi CORREL flag refROI binsize corrROI name thresh | ||
+ | |||
+ | [[jvs: | ||
* -roi CLUSTER refimage flag name | * -roi CLUSTER refimage flag name | ||
* -roi MERGE refimage flag name minvalley minsize mindist | * -roi MERGE refimage flag name minvalley minsize mindist | ||
+ | |||
+ | [[jvs: | ||
* -roi STATS refimage flag showflag mode name value nlevels level0 dlevel | * -roi STATS refimage flag showflag mode name value nlevels level0 dlevel | ||
* -roi STATS refimage flag showflag mode name value cycleleng cycleoff thresh | * -roi STATS refimage flag showflag mode name value cycleleng cycleoff thresh | ||
- | [[jvs: | ||
[[jvs: | [[jvs: | ||
- | [[jvs: | ||
- | |||
- | [[jvs: | ||
- | [[jvs: | ||
- | |||
- | 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: | ||
- | * NAME - specify a name for this ROI (no spaces or punctuation) | ||
- | * X0,Y0,Z0 - specify the starting location of the ROI as upper left corner of the first slice. The default origin is 0,0,0. | ||
- | * NX,NY,NZ - specify the size of the ROI. The default size is 1x1x1 (i.e. a point) if X0,Y0,Z0 are specified, otherwise it is the entire volume. | ||
- | * RAD, | ||
- | * COLOR - specify color for ROI (24-bit RGB value) | ||
The RX type of ROI (when implemented) creates a slice prescription ROI on the current data set based on slice orientation in REFIMAGE. | The RX type of ROI (when implemented) creates a slice prescription ROI on the current data set based on slice orientation in REFIMAGE. | ||
Line 62: | Line 80: | ||
NAME: name of ROI list. If omitted, list is linked to | NAME: name of ROI list. If omitted, list is linked to | ||
- | input mask images. | + | input mask images. |
- | -roi MERGE refimage flag name minvalley | + | -roi MERGE refimage flag name minval |
- | The MERGE command | + | Assumes input data set is roi mask image with an ROI cluster list |
+ | (usually made with ROI CLUSTER command). | ||
+ | allows you to modify | ||
- | MERGE edits the ROI list. Merge adjacent clusters if: | + | Merge can be used in different ways (controlled by FLAG): |
- | 1) distance bet peaks < MINDIST | + | |
- | 2) stat value in valley between peaks is within | + | FLAG 1 - Merge adjacent clusters if: |
- | 3) smaller cluster contains fewer than MINSIZE voxels | + | 1) distance bet peaks < MINDIST |
+ | 2) stat value in valley between peaks is within | ||
+ | 3) smaller cluster contains fewer than MINSIZE voxels | ||
+ | FLAG 2 - Compare input cluster list to REFIMAGE cluster list. | ||
| | ||
- | FLAG: 2 - do not modify | + | FLAG 3 - Compare |
- | (i.e. if merging ROI clusters, change merged mask values) | + | |
| | ||
- | | + | |
- | | + | FLAG 1 - REFIMAGE is a voxel intensity map (e.g. tval map) |
- | | + | FLAG 2 - REFIMAGE |
- | | + | FLAG 3 - REFIMAGE contains ROI images, typically an Atlas ROI map. |
+ | FLAG 4 - Remove clusters containing less than MINVAL voxels | ||
+ | | ||
+ | REFIMAGE mask value (REFVALUE) at cluster center. New cluster index is: | ||
+ | | ||
+ | where I starts at 1 and increments to ensure each cluster has unique index. | ||
| | ||
+ | Other FLAG values: | ||
+ | 8 - do not modify input mask image values when editting ROI list; by default | ||
+ | when ROI clusters are merged or cluster VALUEs are changed, the corresponding | ||
+ | image voxel values are also changed to match the new cluster VALUEs. | ||
+ | 16 - sort cluster list values by peak location (LPI -> RAS) | ||
+ | 32 - sort cluster list by cluster size (largest to smallest) | ||
+ | | ||
+ | NAME: name of ROI list. If omitted, list is linked to input mask images. | ||
+ | |||
-roi STATS refimage flag showflag mode name value nlevels level0 dlevel\\ | -roi STATS refimage flag showflag mode name value nlevels level0 dlevel\\ | ||
-roi STATS refimage flag showflag mode name value cycleleng cycleoff thresh | -roi STATS refimage flag showflag mode name value cycleleng cycleoff thresh | ||
Line 127: | Line 163: | ||
NAME - save stats in file NAME, if specified | NAME - save stats in file NAME, if specified | ||
VAL: if > 0, only calculate for this mask value | VAL: if > 0, only calculate for this mask value | ||
+ | | ||
If FLAG & 02010, time-series by CYCLE, | If FLAG & 02010, time-series by CYCLE, | ||
CYCLELENG: task cycle length in secs | CYCLELENG: task cycle length in secs | ||
Line 136: | Line 172: | ||
LEVEL0: first threshold level (def=0) | LEVEL0: first threshold level (def=0) | ||
DLEVEL: increment between levels (def=1) | DLEVEL: increment between levels (def=1) | ||
- | If input is a Surface: | + | |
+ | | ||
FLAG | FLAG | ||
1 - surface area of AREA ROI or path length of contour ROI | 1 - surface area of AREA ROI or path length of contour ROI |