Last modified by teodoramisan on 2026/02/13 10:11
From version 69.1
edited by teodoramisan
on 2026/02/12 11:50
Change comment: There is no comment for this version
To version 77.3
edited by teodoramisan
on 2026/02/13 10:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -8,7 +8,7 @@
8 8  
9 9  == Purpose ==
10 10  
11 -This is a Jupyter Lab extension that offers graphical support for TVB and VBI workflows. It is already available in the EBRAINS Lab and it allows users to configure and execute TVB simulations and VBI inference workflows directly from a GUI, while drastically reducing the complexity of configuring them inside a Jupyter Lab notebook. Try edit
11 +This is a Jupyter Lab extension that offers graphical support for TVB and VBI workflows. It is already available in the EBRAINS Lab and it allows users to configure and execute TVB simulations and VBI inference workflows directly from a GUI, while drastically reducing the complexity of configuring them inside a Jupyter Lab notebook.
12 12  
13 13  {{html}}
14 14  <iframe width="1200" height="450" src="https://www.youtube.com/embed/-cjZOsU6PBg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
... ... @@ -142,7 +142,7 @@
142 142  [[image:export-model-configuration.png||alt="image-20221116130425-1.png" data-xwiki-image-style-alignment="center" height="763" width="1000"]]
143 143  
144 144  
145 -=== 2. Visualize time series resulted from simulations ===
145 +=== 2. Visualize time series resulted from TVB simulations ===
146 146  
147 147  This functionality is available for the **StoreResultsToDrive** component. Right click on the **StoreResultsToDrive** and select the **Open Viewer** option:
148 148  
... ... @@ -156,6 +156,27 @@
156 156  
157 157  [[image:timeseries-plotly.png||alt="view3.png" height="593" width="1100"]]
158 158  
159 +
160 +=== 3. Visualize posterior samples with a pairplot (VBI inferenece) ===
161 +
162 +This functionality is available for the **SamplePosterior** component. Right click on the component and select the **Open Viewer** functionality.
163 +
164 +This opens a new JupyterLab tab with an editable notebook. After following the instructions in the notebook, you will generate a pairplot of the posterior samples, showing the distribution of each parameter (uncertainty) and the relationships between parameters.
165 +
166 +*Make sure the workflow has been executed so the viewer has data to load.
167 +
168 +[[image:plot-posteriors.png||height="593" width="1100"]]
169 +
170 +
171 +=== 4. Visualize time series from VBI simulations ===
172 +
173 +This functionality is available for the **SimulationRunner** component. Right click on the component and select the **Open Viewer** functionality.
174 +
175 +This opens a new JupyterLab tab with an editable notebook. After following the instructions in the notebook, you will see a simple time-series plot of the simulated model signal over time.
176 +
177 +*Make sure the workflow has been executed so the viewer has data to load.
178 +[[image:plot-timeseries-vbi.png||height="592" width="1100"]]
179 +
159 159  == ==
160 160  
161 161  == Workflow examples ==
... ... @@ -172,14 +172,16 @@
172 172  
173 173  === 2. Full VBI Inference workflow ===
174 174  
175 -Contains all VBI components required to run an inference workflow (e.g., inference configuration, model, simulator, train posterior, sample posterior).
196 +Contains all VBI components required to run an inference workflow, from prior sampling and simulation to posterior training and posterior sampling.
176 176  
177 -[[image:vbi_workflow.png||height="590" width="1100"]]
198 +The workflow starts with **ConfigInference**, which builds the configuration inputs needed by the workflow. It samples parameter values from the prior distribution to generate theta and prepares the feature-extraction configuration (cfg) used later in the pipeline.
178 178  
179 -(% class="wikigeneratedid" %)
180 -{{{ }}}
200 +Next, **SimulationRunner** executes the selected **VBI model** for a batch of parameter samples (theta) using the chosen backend (//cpp//, //cupy// or //numba//). It selects the requested output signal from the model result and extracts the summary features defined in cfg, producing the feature matrix used for training.
181 181  
202 +The resulting features and parameter samples are then passed to **TrainPosterior**, which standardizes the feature matrix with //StandardScaler //and trains a posterior distribution using an SBI method (for example //SNPE//, //SNLE//, or //SNRE//). In the last step, **SamplePosterior** draws parameter samples from the trained posterior distribution, conditioned on the selected observed feature vector.
182 182  
204 +[[image:vbi_workflow.png||height="590" width="1100"]]
205 +
183 183  === 3. Configuring model parameters using the PhasePlaneWidget: ===
184 184  
185 185  Same workflow as before, but the parameter for the model used in simulation are set using the PhasePlaneWidget.
... ... @@ -188,7 +188,6 @@
188 188  <iframe width="1280" height="720" src="https://www.youtube.com/embed/jhGfYul1z9k" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
189 189  {{/html}}
190 190  
191 -
192 192  === 4. Using siibra to retrieve connectivities from the EBRAINS KG ===
193 193  
194 194  A simulation workflow where **siibra **is used to retrieve a connectivity from the EBRAINS KG. That connectivity is fed into a TVB Simulator, where the rest of the parameters (coupling, model, etc.) are set to default values.
... ... @@ -197,10 +197,18 @@
197 197  <iframe width="1280" height="720" src="https://www.youtube.com/embed/hnqTpFGCYMg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
198 198  {{/html}}
199 199  
200 -
201 201  === 5. Run a workflow as an HPB job ===
202 202  
203 203  A workflow simulation which is run remotely, by submitting a job to an HPC site and getting back the results (TimeSeries object).
204 204  
226 +=== 6. Parallel simulations workflow ===
227 +
228 +This example demonstrates **Parameter Space Exploration** (PSE) by running multiple TVB simulations in parallel for different parameter combinations.
229 +
230 +The workflow uses two nested ForEach components to iterate over coupling and conduction speed sets of values. For each (coupling, conduction_speed) pair, a simulation run is executed with the help of the RunParallelProcess component, which runs the workflow body in separate worker processes (using multiprocessing + dill).
231 +
232 +[[image:parallel-simulations.png||height="590" width="1100"]]
233 +
234 +
205 205  {{html}}<iframe width="1280" height="720" src="https://www.youtube.com/embed/M6rZClFgRrM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>{{/html}}
206 206  
parallel-simulations.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.teodoramisan
Size
... ... @@ -1,0 +1,1 @@
1 +325.1 KB
Content
plot-posteriors.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.teodoramisan
Size
... ... @@ -1,0 +1,1 @@
1 +442.0 KB
Content
plot-timeseries-vbi.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.teodoramisan
Size
... ... @@ -1,0 +1,1 @@
1 +579.5 KB
Content
Public

TVB Widgets