-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
executable file
·57 lines (34 loc) · 2.84 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
---------------------------------------------------------------------
xtract_data is the data associated with the XTRACT tool
The HUMAN and MACAQUE tractography protocols were created by:
Rogier Mars, Stamatios Sotiropoulos, Saad Jbabdi, Kathryn Bryant, Shaun Warrington, Marina Charquero-Ballester, Gwenaelle Douaud
The BABY tractography protocols were created by:
Elinor Thompson, Shaun Warrington, Matteo Bastiani, Jessica Dubois, Stamatios Sotiropoulos
The multi-template macaque protocols were created by:
Stephania Assimopoulos, Shaun Warrington, Kathryn Bryant, Rogier Mars, Stamatios Sotiropoulos
---------------------------------------------------------------------
Citations:
Warrington S., Bryant K., Khrapitchev A., Sallet J., Charquero-Ballester M., Douaud G., Jbabdi S.*, Mars R.*, Sotiropoulos S.N.* (2020) XTRACT - Standardised protocols for automated tractography in the human and macaque brain. NeuroImage. DOI: 10.1016/j.neuroimage.2020.116923
Warrington S.*, Thompson E.*, Bastiani M., Dubois J., Baxter L., Slater R., Jbabdi S., Mars R.B., and Sotiropoulos S.N. (2022) “Concurrent mapping of brain ontogeny and phylogeny within a common space: Standardized tractography and applications”, Science Advances, vol. 8(42), doi.org/10.1101/2022.03.03.482776
Assimopoulos S., Warrington S., Bryant K., Pszczolkowski S., Jbabdi S., Mars R.B., and Sotiropoulos S.N. (under review) "Generalising XTRACT Tractography Protocols
Across Common Macaque Brain Templates"
---------------------------------------------------------------------
How to create own 'protocol' folder:
Suppose you want to create an automated protocol for a tract called 'mytrack'.
First you need to create a folder called 'mytrack'.
Then create the following image files (with this exact naming) and copy them into mytrack:
[Compulsory]:
- seed.nii.gz : a seed mask in MNI152 space
[Optional]:
- stop.nii.gz : a stop mask if required
- exclude.nii.gz : an exclusion mask if required
- ONE of the following:
- target.nii.gz : a single target mask
- target1.nii.gz, target2.nii.gz, etc. : a number of targets, in which case streamlines will be kept if they cross ALL of them
- invert (empty file to indicate that a seed->target and target->seed run will be added and combined)
if such an option is required a single "target.nii.gz" file is also expected
In order to use the protocol masks with XTRACT, you need to defined a seeding strategy in a file called StructureList.
See e.g. $FSLDIR/data/xtract_data/Human or $FSLDIR/data/xtract_data/Macaque for examples.
The StructList file is a text file with one entry per tract following this scheme:
`<tractName> <number>`
where `<tractName>` matches the protocol folder name (e.g. 'mytrack'), and <number> is the number of streamlines (in thousands) that are seeded from each seed voxel. This text file can have comments in it (using '#').