jvs:fscan:manual:chapter2:clusters
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
jvs:fscan:manual:chapter2:clusters [2015/06/06 19:31] – voyvodic | jvs:fscan:manual:chapter2:clusters [2017/09/12 23:03] – [Merging Cluster ROIs] voyvodic | ||
---|---|---|---|
Line 3: | Line 3: | ||
====usage: | ====usage: | ||
* -roi CLUSTER refimage flag name | * -roi CLUSTER refimage flag name | ||
- | * -roi MERGE refimage flag name minvalley | + | * -roi MERGE refimage flag name minval |
- | * -roi STATS refimage flag showflag mode name value nlevels level0 dlevel | + | |
====Creating cluster ROIs==== | ====Creating cluster ROIs==== | ||
Line 21: | Line 20: | ||
It creates an ROI list (name=NAME) of clusters where each cluster is defined by its mask value. For each cluster, | It creates 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. | store center-of-mass and radius along principal axes. | ||
- | If REFIMAGE, find peak intensity | + | |
+ | REFIMAGE: | ||
+ | If FLAG & 1, REFIMAGE is another ROI mask data set,\\ | ||
+ | If FLAG & 2, REFIMAGE is another dataset with Cluster list; otherwise REFIMAGE is used to find peak intensity | ||
By default, ROI list is attached to input mask images. | By default, ROI list is attached to input mask images. | ||
- | FLAG: (no values | + | FLAG (values 1-7 specify MODE, values above 7 are flags that can be added to MODE): |
- | + | ||
+ | * 1 - create a new cluster list; 1 cluster for each group of contiguous voxels\\ | ||
+ | * 2 - compare 2 cluster lists\\ | ||
+ | * 8 - assign cluster ROIs new VALUEs based on REFIMAGE ROIs. For each cluster ROI with peak/center inside a REF ROI, the new cluster ROI value is:\\ | ||
+ | | ||
+ | For multiple cluster ROIs within the same REF ROI, the Clus_within_REF_num is assigned a value 0-9. | ||
+ | If(FLAG& | ||
+ | * 16 - sort Cluster | ||
+ | * 32 - sort Cluster values by cluster size (biggest -> smallest) | ||
+ | | ||
NAME: name of ROI list. If omitted, list is linked to input mask images. | NAME: name of ROI list. If omitted, list is linked to input mask images. | ||
+ | ==== Merging Cluster ROIs ==== | ||
-roi MERGE refimage flag name minvalley minsize mindist | -roi MERGE refimage flag name minvalley minsize mindist | ||
- | The MERGE command assumes | + | The ROI MERGE command assumes |
+ | (usually made with ROI CLUSTER command). The ROI MERGE command | ||
+ | allows you to modify the input data set and/or its Cluster list. | ||
- | MERGE edits the ROI list. Merge adjacent clusters if: | + | Merge can be used in different ways (controlled by FLAG). |
- | | + | |
- | | + | FLAG (values 1-7 specify MODE, values above 7 are flags that can be added to MODE): |
- | | + | FLAG 1 - Merge adjacent clusters if: |
- | + | | |
- | FLAG: 2 - do not modify input mask image values when editting ROI list | + | |
- | (i.e. if merging | + | |
- | + | | |
+ | FLAG 3 - Compare input cluster list to mask ROIs in REFIMAGE. | ||
+ | FLAG 4 - Delete clusters with size smaller than MINVAL voxels | ||
+ | FLAG 5 - Modify cluster index based on REFIMAGE mask | ||
+ | New index is: | ||
+ | where I starts at 1 and increments to ensure each cluster has unique index. | ||
+ | |||
+ | REFIMAGE is the reference data set; the type of data depends on FLAG: | ||
+ | FLAG 1 - REFIMAGE is a voxel intensity map (e.g. tval map) | ||
+ | FLAG 2 - REFIMAGE is another mask image with attached cluster list. | ||
+ | FLAG 3 or 5 - REFIMAGE contains ROI images, typically an Atlas ROI map. | ||
+ | |||
+ | Other FLAG values: | ||
+ | 8 - do not modify input mask image values when editting ROI list; | ||
+ | by default when ROI clusters | ||
+ | the corresponding image voxel 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.\\ | NAME: name of ROI list. If omitted, list is linked to input mask images.\\ | ||
- | MINVALLEY: (default= 60% of lower peak maximum)\\ | + | MINVAL: (default= 60% of lower peak maximum)\\ |
MINSIZE: (default= 5 voxels)\\ | MINSIZE: (default= 5 voxels)\\ | ||
MINDIST: (default= 40 mm)\\ | MINDIST: (default= 40 mm)\\ | ||
Line 47: | Line 80: | ||
**See Also:**\\ | **See Also:**\\ | ||
+ | [[jvs: | ||
+ | [[jvs: | ||
+ | [[jvs: | ||
+ | [[jvs: | ||
+ | [[jvs: | ||
+ | |||
[[jvs: | [[jvs: | ||
[[jvs: | [[jvs: | ||
[[jvs: | [[jvs: | ||
[[jvs: | [[jvs: |
jvs/fscan/manual/chapter2/clusters.txt · Last modified: 2024/06/21 15:44 by 127.0.0.1