Changes for page TVB PIPELINE

Last modified by ldomide on 2024/05/20 08:56
From version 17.1
edited by michaels
on 2020/05/06 13:44
Change comment: There is no comment for this version
To version 40.1
edited by michaels
on 2021/11/30 10:56
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -2,36 +2,17 @@
2 2  (((
3 3  (% class="container" %)
4 4  (((
5 -= From MRI to Functional and Structural Connectivity =
5 +== TVB Image Processing Pipeline ==
6 6  
7 -Neuroimaging data preprocessing pipeline
7 +=== [[Web-GUI to configure and start processing on HPC>>https://thevirtualbrain.apps.hbp.eu/||target="_blank"]] ===
8 8  
9 -[[image:8677353.png||style="float:left"]]
9 +==== [[Pipeline Video Tutorial>>https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view||rel="noopener noreferrer" target="_blank"]] ====
10 10  
11 -== ==
11 +==== [[Direct link to notebook>>https://drive.ebrains.eu/#my-libs/lib/42ac27a5-981e-4cf6-8ec5-d67b0c24bf09/notebooks||rel="noopener noreferrer" target="_blank"]] ====
12 12  
13 -== ==
13 +[[image:8677353.png||style="float:left"]]
14 14  
15 -== ==
16 -
17 -== ==
18 -
19 -== ==
20 -
21 -== ==
22 -
23 -== ==
24 -
25 -(% class="wikigeneratedid" %)
26 -== ==
27 -
28 -(% class="wikigeneratedid" %)
29 -== ==
30 -
31 -(% class="wikigeneratedid" %)
32 -== ==
33 -
34 -== [[Pipeline Video Tutorial>>https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view||rel="noopener noreferrer" target="_blank"]] ==
15 +
35 35  )))
36 36  )))
37 37  
... ... @@ -39,26 +39,108 @@
39 39  (((
40 40  (% class="col-xs-12 col-sm-8" %)
41 41  (((
23 +== Quick links ==
24 +
25 +* [[TVB on EBRAINS (Short Version)>>https://www.youtube.com/watch?v=EETRdGskiWQ&t=2s||rel="noopener noreferrer" target="_blank"]]
26 +* [[TVB on EBRAINS (Long Version)>>https://www.youtube.com/watch?v=VYhR9RNRIpA&t=2s||rel="noopener noreferrer" target="_blank"]]
27 +* [[TVB on EBRAINS (Mini Videos)>>url:https://www.youtube.com/playlist?list=PLVtblERyzDeLcVv4BbW3BvmO8D-qVZxKf||rel="noopener noreferrer" target="_blank"]]
28 +* [[User Story>>url:https://wiki.ebrains.eu/bin/view/Collabs/user-story-tvb/]]
29 +
42 42  == What can I find here? ==
43 43  
44 44  * an IPython notebook that describes how to
45 -** use the TVB pipeline on one of the associated supercomputers using PyUnicore
46 -** upload model data to the supercomputer
33 +** use the TVB processing pipeline on one of the associated supercomputers using PyUnicore
34 +** upload MRI data to the supercomputer
47 47  ** set up and run the pipeline
48 48  ** download processing results
49 49  
38 +== What does the TVB processing pipeline do? ==
39 +
40 +After uploading MRI data to the supercomputer, the pipeline runs the three containers
41 +
42 +* [[bids/mrtrix3_connectome>>https://hub.docker.com/r/bids/mrtrix3_connectome||rel="noopener noreferrer" target="_blank"]]
43 +* [[poldracklab/fmriprep>>https://hub.docker.com/r/poldracklab/fmriprep||rel="noopener noreferrer" target="_blank"]], and
44 +* [[thevirtualbrain/tvb_converter>>https://hub.docker.com/r/thevirtualbrain/tvb_converter||rel="noopener noreferrer" target="_blank"]]
45 +
46 +The TVB Processing Pipeline takes multimodal MRI data sets (anatomical, functional and diffusion-weighted MRI) as input and generates SCs, region-average fMRI time series, FCs, brain surfaces, electrode positions, lead field matrices, and atlas parcellations as output. The pipeline performs preprocessing and distortion-correction on MRI data as well as white matter fiber bundle tractography on diffusion data. Outputs are formatted according to two data standards: a TVB-ready data set that can be directly used to simulate brain network models and the same output in BIDS format.
47 +
50 50  == How do I use it? ==
51 51  
52 52  * the pipeline is implemented by three Docker containers (mrtrix3_connectome, fmriprep and tvb_converter)
53 -* the containers are executed on supercomputers and operated via IPython notebooks
51 +* the containers are executed on supercomputers and operated via the [[web GUI>>https://thevirtualbrain.apps.hbp.eu/]] or via IPython notebooks
54 54  * Find the notebook by clicking on "Drive" in the left menu. The notebook is located in the folder "notebooks"
55 55  * Direct link to notebook: [[https:~~/~~/drive.ebrains.eu/#my-libs/lib/42ac27a5-981e-4cf6-8ec5-d67b0c24bf09/notebooks>>url:https://drive.ebrains.eu/#my-libs/lib/42ac27a5-981e-4cf6-8ec5-d67b0c24bf09/notebooks]]
56 56  * To use the notebook, download it onto your local filesystem, create a new Collab and upload it there.
57 57  * Then, head over to [[https:~~/~~/lab.ebrains.eu/>>url:https://lab.ebrains.eu/||rel="noopener noreferrer" target="_blank"]] to edit and run your notebook.
58 58  * Depending on whether you created a public or a private notebook it will be accessible in either "drive/Shared with all" or "drive/Shared with groups'"
57 +
58 +== Metadata ==
59 +
60 +|=Category|tool
61 +|=Tags|(((
62 +* [[Simulaton>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
63 +* [[TVB>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
64 +* [[visualization>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
65 +* [[open-source>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
66 +* [[analysis>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
67 +* [[supercomputers>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
68 +* [[brain-model>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
69 +* [[neuroinformatics>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
70 +* [[image-segmentation>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
71 +* [[simulation>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
72 +* [[The-Virtual-Brain>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
59 59  )))
74 +|=Partners|(((
75 +* Charité Universitätsmedizin Berlin [[CHARITE>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
76 +)))
77 +|=Maintainers|(((
78 +* [[Petra Ritter>>path:mailto:petra.ritter@charite.de]]
79 +* [[Michael Schirner>>path:mailto:michael.schirner@charite.de]]
80 +* [[Paul Triebkorn>>path:mailto:jan-paul.triebkorn@charite.de]]
81 +)))
82 +|=Contributors|(((
83 +* [[Petra Ritter>>path:mailto:petra.ritter@charite.de]]
84 +* [[Michael Schirner>>path:mailto:michael.schirner@charite.de]]
85 +* [[Paul Triebkorn>>path:mailto:jan-paul.triebkorn@charite.de]]
86 +)))
87 +|=Homepage|[[https:~~/~~/www.brainsimulation.org>>url:https://www.brainsimulation.org/]]
88 +|=Documentation|[[https:~~/~~/drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view>>url:https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view]]
89 +|=Support|[[petra.ritter@charite.de>>path:mailto:petra.ritter@charite.de]]
90 +|=Source Code|[[https:~~/~~/hub.docker.com/r/thevirtualbrain/tvb_converter>>url:https://hub.docker.com/r/thevirtualbrain/tvb_converter]]
91 +|=Download Page|[[https:~~/~~/hub.docker.com/r/thevirtualbrain/tvb_converter>>url:https://hub.docker.com/r/thevirtualbrain/tvb_converter]]
92 +|=License|GPLv3
93 +|=Current Version|1.0
94 +|=All Versions|(((
95 +* 1.0
96 +)))
60 60  
98 +=== ===
61 61  
100 +== Publications on TVB/brain model preprocessing ==
101 +
102 +* [[https:~~/~~/www.ncbi.nlm.nih.gov/pubmed/25837600>>url:https://www.ncbi.nlm.nih.gov/pubmed/25837600]]
103 +* [[https:~~/~~/www.ncbi.nlm.nih.gov/pubmed/27480624>>url:https://www.ncbi.nlm.nih.gov/pubmed/27480624]]
104 +
105 +== Citing this work ==
106 +
107 +
108 +When using this pipeline for published work, please acknowledge MRtrix3, MRtrix3_connectome (R. Smith & Connelly, 2019; Tournier et al., 2019) and fmriprep (Esteban et al., 2019).
109 +
110 +
111 +Esteban, O., Markiewicz, C. J., Blair, R. W., Moodie, C. A., Isik, A. I., Erramuzpe, A., Kent, J. D., Goncalves, M., DuPre, E., Snyder, M., Oya, H., Ghosh, S. S., Wright, J., Durnez, J., Poldrack, R. A., & Gorgolewski, K. J. (2019). fMRIPrep: a robust preprocessing pipeline for functional MRI. //Nature Methods//. [[https:~~/~~/doi.org/10.1038/s41592-018-0235-4>>https://doi.org/10.1038/s41592-018-0235-4]]
112 +
113 +
114 +Schirner, M., Rothmeier, S., Jirsa, V. K., McIntosh, A. R., & Ritter, P. (2015). An automated pipeline for constructing personalized virtual brains from multimodal neuroimaging data. NeuroImage, 117, 343-357.  
115 +
116 +
117 +Smith, R., & Connelly, A. (2019). MRtrix3_connectome: A BIDS Application for quantitative structural connectome construction. //OHBM//, W610.
118 +
119 +
120 +Tournier, J. D., Smith, R., Raffelt, D., Tabbara, R., Dhollander, T., Pietsch, M., Christiaens, D., Jeurissen, B., Yeh, C. H., & Connelly, A. (2019). MRtrix3: A fast, flexible and open software framework for medical image processing and visualisation. In //NeuroImage//. https:~/~/doi.org/10.1016/j.neuroimage.2019.116137
121 +)))
122 +
123 +== ==
124 +
62 62  (% class="col-xs-12 col-sm-4" %)
63 63  (((
64 64  {{box title="**Contents**"}}
Collaboratory.Apps.Collab.Code.CollabClass[0]
Description
... ... @@ -1,1 +1,1 @@
1 -Construct brain network models from empirical MRI data.
1 +TVB Image Processing Pipeline With MINDS annotated Outputs
XWiki.XWikiRights[3]
Allow/Deny
... ... @@ -1,1 +1,0 @@
1 -Allow
Levels
... ... @@ -1,1 +1,0 @@
1 -view
Users
... ... @@ -1,1 +1,0 @@
1 -XWiki.XWikiGuest
XWiki.XWikiRights[4]
Allow/Deny
... ... @@ -1,1 +1,0 @@
1 -Allow
Groups
... ... @@ -1,1 +1,0 @@
1 -XWiki.XWikiAllGroup
Levels
... ... @@ -1,1 +1,0 @@
1 -view
XWiki.XWikiRights[7]
Allow/Deny
... ... @@ -1,0 +1,1 @@
1 +Allow
Levels
... ... @@ -1,0 +1,1 @@
1 +view
Users
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
XWiki.XWikiRights[8]
Allow/Deny
... ... @@ -1,0 +1,1 @@
1 +Allow
Groups
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiAllGroup
Levels
... ... @@ -1,0 +1,1 @@
1 +view
Public

TVB PIPELINE