Differences between revisions 1 and 27 (spanning 26 versions)
Revision 1 as of 2018-08-15 13:05:17
Size: 668
Comment:
Revision 27 as of 2018-09-29 15:59:24
Size: 3150
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
## IMPORTANT NOTE:
## When you use this page as a template for creating your project page:
## * please remove all lines starting with two hashes (##)
## * except the acl line, please keep that, but remove one hash, so it reads #acl ...
## * fix the acl line so it has the correct page instead of the sample Project/...Group
##acl Project/AdminGroup:admin,read,write,delete,revert Project/ReadWriteGroup:read,write Project/ReadGroup:read
##master-page:Unknown-Page
##master-date:Unknown-Date
#format wiki
#language en
sdadas
= AnatomiCuts =

'''AnatomiCuts''' is an unsupervised hierarchical clustering that uses an anatomical similarity metric.
 {{attachment:anatomiCuts_tree.jpg||height="360px"}}{{attachment:rainbow_brain.png||height="360px"}}

<<TableOfContents>>

== Inputs ==

- streamlines file (*.trk)

- a segmentation image, preferable including cortical and subcortical parcellation with white matter segmentation based on neighboring regions (wmparc.mgz or wm2009parc.mgz).

'''It is important to ensure that the streamlines and the segmentation are in the same space.''' To validate this it is recommended to visualize the streamline file and the segmentation file using '''both''' Freeview and Trackvis, since Freeview does not take into account RAS orientation, and Trackvis does not take into account the image offset.


== Filtering streamlines ==
Sometimes deterministic tractography can generate spurious streamlines outside the brain. To exclude them we can use [[streamlineFilter| streamlineFilter]]. It is recommended to remove the short streamlines that can prematurely end during tractography. It is also possible to remove the ushape streamlines.

= Running AnatomiCuts =
{{{
AnatomiCuts -s segmentation.nii.gz -f streamlines.vtk -labels -o outputFolder <options>
}}}
Where

-s segmentation file such as wm2009parc.nii.gz

-f streamline file in trk format.

-c number of clusters

-s segmentation file such as wm2009parc.nii.gz

-f streamline file in trk format.

-c number of clusters. The default is 200.

-n number of points to be used per streamline. The default is 10.

-e number of streamlines to be used for the eigendecomposition of normalized cuts algorithm. The default is 500. Using less number of streamlines will fasten substantially the algorithm at the expense of accuracy. For a quick test 50 could be ok, but in practice, less than 300 is not recommended.

-d directional neighbors to be used, the default is "a" all (26), diagonal "d" is 14 and straight "s" is 6.

-n number of points to be used per streamline. The default is 10.

-e number of streamlines to be used for the eigendecomposition of normalized cuts algorithm. The default is 500. Using less number of streamlines will fasten substantially the algorithm at the expense of accuracy. For a quick test 50 could be ok, but in practice, less than 300 is not recommended.

-d directional neighbors to be used, the default is "a" all (26), diagonal "d" is 14 and straight "s" is 6.


= Finding corresponding clusters across subjects =

You can find one-to-one correspondences using [[AnatomiCuts_correspondences| AnatomiCuts_correspondences]].

= Visualizing AnatomiCuts in Freeview =

To load the clusters obtained with AnatomiCuts got to "File -> Load Tract Cluster" and select the AnatomiCuts output folder.
 {{attachment:anatomiCuts_freeview.jpg||height="360px"}}{{attachment:anatomicus_freeview_tree.png||height="360px"}}

= References =
AnatomiCuts: Hierarchical clustering of tractography streamlines based on anatomical similarity. Siless V., Chang K., Fischl B., Yendiki A.. NeuroImage 2018.

AnatomiCuts

AnatomiCuts is an unsupervised hierarchical clustering that uses an anatomical similarity metric.

  • anatomiCuts_tree.jpgrainbow_brain.png

Inputs

- streamlines file (*.trk)

- a segmentation image, preferable including cortical and subcortical parcellation with white matter segmentation based on neighboring regions (wmparc.mgz or wm2009parc.mgz).

It is important to ensure that the streamlines and the segmentation are in the same space. To validate this it is recommended to visualize the streamline file and the segmentation file using both Freeview and Trackvis, since Freeview does not take into account RAS orientation, and Trackvis does not take into account the image offset.

Filtering streamlines

Sometimes deterministic tractography can generate spurious streamlines outside the brain. To exclude them we can use streamlineFilter. It is recommended to remove the short streamlines that can prematurely end during tractography. It is also possible to remove the ushape streamlines.

Running AnatomiCuts

AnatomiCuts -s segmentation.nii.gz -f streamlines.vtk  -labels  -o outputFolder  <options> 

Where

-s segmentation file such as wm2009parc.nii.gz

-f streamline file in trk format.

-c number of clusters

-s segmentation file such as wm2009parc.nii.gz

-f streamline file in trk format.

-c number of clusters. The default is 200.

-n number of points to be used per streamline. The default is 10.

-e number of streamlines to be used for the eigendecomposition of normalized cuts algorithm. The default is 500. Using less number of streamlines will fasten substantially the algorithm at the expense of accuracy. For a quick test 50 could be ok, but in practice, less than 300 is not recommended.

-d directional neighbors to be used, the default is "a" all (26), diagonal "d" is 14 and straight "s" is 6.

-n number of points to be used per streamline. The default is 10.

-e number of streamlines to be used for the eigendecomposition of normalized cuts algorithm. The default is 500. Using less number of streamlines will fasten substantially the algorithm at the expense of accuracy. For a quick test 50 could be ok, but in practice, less than 300 is not recommended.

-d directional neighbors to be used, the default is "a" all (26), diagonal "d" is 14 and straight "s" is 6.

Finding corresponding clusters across subjects

You can find one-to-one correspondences using AnatomiCuts_correspondences.

Visualizing AnatomiCuts in Freeview

To load the clusters obtained with AnatomiCuts got to "File -> Load Tract Cluster" and select the AnatomiCuts output folder.

References

AnatomiCuts: Hierarchical clustering of tractography streamlines based on anatomical similarity. Siless V., Chang K., Fischl B., Yendiki A.. NeuroImage 2018.

AnatomiCuts (last edited 2019-06-05 04:35:50 by VivianaSiless)