Changes for page TVB PIPELINE

Last modified by ldomide on 2024/05/20 08:56
From version 7.1
edited by michaels
on 2020/05/06 09:11
Change comment: There is no comment for this version
To version 41.1
edited by michaels
on 2021/11/30 10:58
Change comment: There is no comment for this version

Summary

Details

Page properties
Tags
... ... @@ -1,0 +1,1 @@
1 +tool|CHARITE|Simulation|tvb|visualisation|open source|analysis|supercomputer|brain model|neuroinformatics|image processing|the virtual brain
Content
... ... @@ -2,9 +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/||rel="noopener noreferrer" target="_blank"]] ===
8 +
9 +==== [[Pipeline Video Tutorial>>https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view||rel="noopener noreferrer" target="_blank"]] ====
10 +
11 +==== [[Direct link to notebook>>https://drive.ebrains.eu/#my-libs/lib/42ac27a5-981e-4cf6-8ec5-d67b0c24bf09/notebooks||rel="noopener noreferrer" target="_blank"]] ====
12 +
13 +[[image:8677353.png||style="float:left"]]
14 +
15 +
8 8  )))
9 9  )))
10 10  
... ... @@ -12,16 +12,111 @@
12 12  (((
13 13  (% class="col-xs-12 col-sm-8" %)
14 14  (((
15 -= What can I find here? =
23 +== Quick links ==
16 16  
25 +* [[TVB Pipeline Web GUI>>https://thevirtualbrain.apps.hbp.eu/]]
26 +* [[TVB on EBRAINS (Short Version)>>https://www.youtube.com/watch?v=EETRdGskiWQ&t=2s||rel="noopener noreferrer" target="_blank"]]
27 +* [[TVB on EBRAINS (Long Version)>>https://www.youtube.com/watch?v=VYhR9RNRIpA&t=2s||rel="noopener noreferrer" target="_blank"]]
28 +* [[TVB on EBRAINS (Mini Videos)>>url:https://www.youtube.com/playlist?list=PLVtblERyzDeLcVv4BbW3BvmO8D-qVZxKf||rel="noopener noreferrer" target="_blank"]]
29 +* [[User Story>>url:https://wiki.ebrains.eu/bin/view/Collabs/user-story-tvb/]]
30 +
31 +== What can I find here? ==
32 +
33 +* a [[link>>https://thevirtualbrain.apps.hbp.eu/]] to the Web App for using the pipeline via GUI
34 +* the code underlying the pipeline including the orchestrator that manages processing on the supercomputer
17 17  * an IPython notebook that describes how to
18 -** use the TVB pipeline on one of the associated supercomputers using PyUnicore
19 -** upload model data to the supercomputer
36 +** use the TVB processing pipeline on one of the associated supercomputers using PyUnicore
37 +** upload MRI data to the supercomputer
20 20  ** set up and run the pipeline
21 21  ** download processing results
40 +
41 +== What does the TVB processing pipeline do? ==
42 +
43 +After uploading MRI data to the supercomputer, the pipeline runs the three containers
44 +
45 +* [[bids/mrtrix3_connectome>>https://hub.docker.com/r/bids/mrtrix3_connectome||rel="noopener noreferrer" target="_blank"]]
46 +* [[poldracklab/fmriprep>>https://hub.docker.com/r/poldracklab/fmriprep||rel="noopener noreferrer" target="_blank"]], and
47 +* [[thevirtualbrain/tvb_converter>>https://hub.docker.com/r/thevirtualbrain/tvb_converter||rel="noopener noreferrer" target="_blank"]]
48 +
49 +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.
50 +
51 +== How do I use it? ==
52 +
53 +* the pipeline is implemented by three Docker containers (mrtrix3_connectome, fmriprep and tvb_converter)
54 +* the containers are executed on supercomputers and operated via the [[web GUI>>https://thevirtualbrain.apps.hbp.eu/]] or via IPython notebooks
55 +* Find the notebook by clicking on "Drive" in the left menu. The notebook is located in the folder "notebooks"
56 +* 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]]
57 +* To use the notebook, download it onto your local filesystem, create a new Collab and upload it there.
58 +* Then, head over to [[https:~~/~~/lab.ebrains.eu/>>url:https://lab.ebrains.eu/||rel="noopener noreferrer" target="_blank"]] to edit and run your notebook.
59 +* 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'"
60 +
61 +== Metadata ==
62 +
63 +|=Category|tool
64 +|=Tags|(((
65 +* [[Simulaton>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
66 +* [[TVB>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
67 +* [[visualization>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
68 +* [[open-source>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
69 +* [[analysis>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
70 +* [[supercomputers>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
71 +* [[brain-model>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
72 +* [[neuroinformatics>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
73 +* [[image-segmentation>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
74 +* [[simulation>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
75 +* [[The-Virtual-Brain>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
22 22  )))
77 +|=Partners|(((
78 +* Charité Universitätsmedizin Berlin [[CHARITE>>url:https://services.humanbrainproject.eu/software-catalog/catalog/?ctx=97d59245-adce-42c4-8b50-d22587071fcd&ctxstate=search%2Ctvb]]
79 +)))
80 +|=Maintainers|(((
81 +* [[Petra Ritter>>path:mailto:petra.ritter@charite.de]]
82 +* [[Michael Schirner>>path:mailto:michael.schirner@charite.de]]
83 +* [[Paul Triebkorn>>path:mailto:jan-paul.triebkorn@charite.de]]
84 +)))
85 +|=Contributors|(((
86 +* [[Petra Ritter>>path:mailto:petra.ritter@charite.de]]
87 +* [[Michael Schirner>>path:mailto:michael.schirner@charite.de]]
88 +* [[Paul Triebkorn>>path:mailto:jan-paul.triebkorn@charite.de]]
89 +)))
90 +|=Homepage|[[https:~~/~~/www.brainsimulation.org>>url:https://www.brainsimulation.org/]]
91 +|=Documentation|[[https:~~/~~/drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view>>url:https://drive.google.com/file/d/1VcXf3GX3KoihF4UzJQXzuGL4XWoqj5Jr/view]]
92 +|=Support|[[petra.ritter@charite.de>>path:mailto:petra.ritter@charite.de]]
93 +|=Source Code|[[https:~~/~~/hub.docker.com/r/thevirtualbrain/tvb_converter>>url:https://hub.docker.com/r/thevirtualbrain/tvb_converter]]
94 +|=Download Page|[[https:~~/~~/hub.docker.com/r/thevirtualbrain/tvb_converter>>url:https://hub.docker.com/r/thevirtualbrain/tvb_converter]]
95 +|=License|GPLv3
96 +|=Current Version|1.0
97 +|=All Versions|(((
98 +* 1.0
99 +)))
23 23  
101 +=== ===
24 24  
103 +== Publications on TVB/brain model preprocessing ==
104 +
105 +* [[https:~~/~~/www.ncbi.nlm.nih.gov/pubmed/25837600>>url:https://www.ncbi.nlm.nih.gov/pubmed/25837600]]
106 +* [[https:~~/~~/www.ncbi.nlm.nih.gov/pubmed/27480624>>url:https://www.ncbi.nlm.nih.gov/pubmed/27480624]]
107 +
108 +== Citing this work ==
109 +
110 +
111 +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).
112 +
113 +
114 +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]]
115 +
116 +
117 +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.  
118 +
119 +
120 +Smith, R., & Connelly, A. (2019). MRtrix3_connectome: A BIDS Application for quantitative structural connectome construction. //OHBM//, W610.
121 +
122 +
123 +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
124 +)))
125 +
126 +== ==
127 +
25 25  (% class="col-xs-12 col-sm-4" %)
26 26  (((
27 27  {{box title="**Contents**"}}
8677353.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.michaels
Size
... ... @@ -1,0 +1,1 @@
1 +227.9 KB
Content
8d975cf4-13ec-4a6d-9fd9-064bd1fac7b0.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.michaels
Size
... ... @@ -1,0 +1,1 @@
1 +107.1 KB
Content
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