Changes for page TVB PIPELINE

Last modified by ldomide on 2024/05/20 08:56
From version 22.1
edited by michaels
on 2020/05/06 14:26
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,32 +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 -== [[Pipeline Video Tutorial>>https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view||rel="noopener noreferrer" target="_blank"]] ==
9 +==== [[Pipeline Video Tutorial>>https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view||rel="noopener noreferrer" target="_blank"]] ====
10 10  
11 -== [[Direct link to notebook>>https://drive.ebrains.eu/#my-libs/lib/42ac27a5-981e-4cf6-8ec5-d67b0c24bf09/notebooks||target="_blank"]] ==
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 -
14 14  [[image:8677353.png||style="float:left"]]
15 15  
16 -== ==
17 -
18 -== ==
19 -
20 -== ==
21 -
22 -== ==
23 -
24 -== ==
25 -
26 -== ==
27 -
28 -== ==
29 -
30 -== ==
15 +
31 31  )))
32 32  )))
33 33  
... ... @@ -35,18 +35,35 @@
35 35  (((
36 36  (% class="col-xs-12 col-sm-8" %)
37 37  (((
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 +
38 38  == What can I find here? ==
39 39  
40 40  * an IPython notebook that describes how to
41 -** use the TVB pipeline on one of the associated supercomputers using PyUnicore
42 -** 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
43 43  ** set up and run the pipeline
44 44  ** download processing results
45 45  
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 +
46 46  == How do I use it? ==
47 47  
48 48  * the pipeline is implemented by three Docker containers (mrtrix3_connectome, fmriprep and tvb_converter)
49 -* 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
50 50  * Find the notebook by clicking on "Drive" in the left menu. The notebook is located in the folder "notebooks"
51 51  * 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]]
52 52  * To use the notebook, download it onto your local filesystem, create a new Collab and upload it there.
... ... @@ -55,21 +55,70 @@
55 55  
56 56  == Metadata ==
57 57  
58 -* Partners: Charité Universitätsmedizin Berlin
59 -* Developers: Michael Schirner (michael.schirner@charite.de), Paul Triebkorn
60 -* Support: Petra Ritter (petra.ritter@charite.de)
61 -* Homepage: [[https:~~/~~/www.brainsimulation.org>>url:https://www.brainsimulation.org/]]
62 -* Documentation: [[https:~~/~~/drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view>>https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view]]
63 -* Download as Docker image~: [[https:~~/~~/hub.docker.com/r/thevirtualbrain/tvb_converter>>url:https://hub.docker.com/r/thevirtualbrain/tvb_converter]]
64 -* License: GPL3
65 -* Version: 1.0
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]]
73 +)))
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 +)))
66 66  
98 +=== ===
99 +
67 67  == Publications on TVB/brain model preprocessing ==
68 68  
69 69  * [[https:~~/~~/www.ncbi.nlm.nih.gov/pubmed/25837600>>url:https://www.ncbi.nlm.nih.gov/pubmed/25837600]]
70 70  * [[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
71 71  )))
72 72  
123 +== ==
73 73  
74 74  (% class="col-xs-12 col-sm-4" %)
75 75  (((
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