Changes for page SGA3 D1.2 Showcase 1
Last modified by fousekjan on 2022/07/04 18:31
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 5 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -12,37 +12,73 @@ 12 12 ((( 13 13 (% class="col-xs-12 col-sm-8" %) 14 14 ((( 15 - ==Siibra- Python clientforaccessingthehumanatlas==15 +The Showcase is implemented as a series of interactive Jupyter notebooks covering the individual logical steps and can be accessed in a dedicated public EBRAINS collab. 16 16 17 -The multilevel atlas interface called siibra (formerly known as Brainscapes) is designed to allow safe and convenient interaction with brain definitions from different parcellations, facilitating the implementation of reproducible neuroscience workflows on the basis of brain atlases. It allows to work with reference brain templates both at millimeter and micrometer resolutions and provides streamlined access to multimodal data features linked to brain regions. In particular in this demonstrator it is used to retrieve the dataset of receptor density spatial maps. 18 18 19 -The S howcase1a isbuilt onthe[[connectivitydatafromthe1000BRAINSstudy>>https://doi.org/10.25493%2F6640-3XH]]available in theKnowledge graph as adatasetwithprotectedaccessavailable toEBRAINS users. The accesstoprotecteddatasetsisprovidedinEBRAINS through the[[HumanDataGateway>>https://wiki.ebrains.eu/bin/view/Collabs/data-proxy/Human%20Data%20Gateway/]]whichallowsfullaccessoncetheuserhasvalidatedthe termsofuse.18 +The EBRAINS collab consists of interlinked Drive, Bucket, Wiki, and Lab. The Drive provides small file storage and contains the notebooks and all supporting code. The Bucket is a large file storage service and holds the pre-computed results of the extensive parameter sweeps and model optimizations to allow skipping the computationally demanding steps. The documentation of the showcase implementation is collected in the Wiki. The Lab service is an instance of JupyterLab—an interactive computing environment where the notebooks can be run and worked with. 20 20 21 -== Brain Network Modeling: TVB == 22 22 23 -The second major componentoftheshowcaseisTheVirtualBrain(TVB) simulationplatform. TVB isa simulationplatformthatusesempirical structural and functionaldata to buildwholebrainmodels ofindividual subjects.Forconvenientmodelconstruction,thesystemis basedonaprocessingpipelineforstructural,functional, and diffusion-weightedmagneticresonanceimaging(MRI)data.Thepipelinecombinesseveralstate-of-the-artneuroinformaticstoolstogeneratesubject-specific cortical andsubcorticalparcellations,surface-tessellations,structural andfunctionalconnectomes, andregion-wiseaggregatedblood oxygen level-dependent (BOLD) functionalMRI(fMRI) time-series.21 +The notebooks in this collab will load all required Python modules including Siibra and The Virtual Brain, and the interfaces for launching the computationally demanding parts in the HPC infrastructure. Running the notebooks requires an EBRANS account with permissions to access the Lab and the Knowledge Graph API. In addition, to be able to interact with the HPC infrastructure, the user has to have access to an active allocation on the corresponding FENIX site. 24 24 25 -== S ystematic parameter explorationandparameteroptimization==23 +== Simulation of resting state == 26 26 27 -The third component isdistributedexecutionof systematic parameter explorationand parameter optimizationontheHigh Performance Computing (HPC)infrastructure available in the FENIX RI. The unifiedaccess to the federated infrastructure is enabledby the pyunicore library providingaconcise API to the common tasks such as compute jobsubmission and management.That allowed us tocreate simplified interfaces forthejupyterlab environment fortheuserto run theparameter explorations. Forthe Showcase 1a we haveimplemented custom library for distributedsimulationscompatible with the controlleddataaccess through theHuman dataGateway. The showcase 1b is making use of theLearningto Learn (L2L), which is a gradient-free optimization framework that containswell-documentedand tested implementations of various gradient-free optimizationalgorithms.It alsodefinesan APIthatmakesit easy to optimize (hyper-)parameters for any task (throughaconstruct calledan“optimizee”). All the implementationsin this package are parallel and can run across differentcoresandnodes (but equally well on a single core). The basic idea behind“Learning to Learn” istohave an “outerloop” optimizeroptimizing theparameters of an “innerloop”optimizee. Thisparticular framework is written for the case where the cycle starts when the outer-loop optimizer generates an instance of a set of parameters andprovides it to the inner-loopoptimizee.Then,theinner-loop optimizee evaluateshowwell thisset of parameters performs andreturnsa “fitness” vector for each parameter in the set of parameters. Lastly, the outer-loop optimizer generates a new set ofparameters using thefitness vectorit got back from the inner-loopoptimizee. On the whole, what thismeansis that the outer-loop Optimizer works only with parameters andfitness valuesand doesn’t have access to the actualunderlying model of the optimizee. The only thing the optimizeedoesis to evaluate the fitness of the given parameter.In our implementation, this fitnessfunction is defined to minimize the distance between empirical and simulated BOLD signals throughtheswFCDobservable, as described above. Once properly configured,L2L allows runningthe simulation fora “mean” subjectsignal built as an average of allindividual subjects in the dataset,or for each such individual subject inparticular. Thisexecutionis distributedontop of the computing capabilitiesof the Jülich supercomputing center, which allows computingin a matterof minutes which otherwise would take several days to compute. In the currentimplementation, a systematicparametersweepwas used to guaranteeaccurately finding a global minimum of theparameters to fit.25 +The fist notebook in the inter-individual variability workflow explores the resting-state simulation for a subject of the 1000BRAINS dataset. Functional data are simulated by means of a brain network model implemented in TVB, which is an ensemble of neural mass models linked via the weights of the structural connectivity (SC) matrix. Following topics are covered: 28 28 29 -In addition to the systematic parameter exploration, we have integrated a Bayesian framework allowing for inference of the full posterior values of the parameters as a fourth component for the Showcase 1a. For this we have employed the Simulation Based Inference (SBI) in which a deep neural estimator is trained to provide a relationship between the parameters of a model (black box simulator), and selected descriptive statistics of the observed data. As numerous repeated simulations are at the core of the training phase of SBI (sampling of the prior parameter distributions), the implementation can reuse the infrastructure for the systematic parameter sweeps on the HPC infrastructure. Specifically, for each subject an estimator was trained on 2000 simulations to retrieve the global coupling parameter G using the properties of functional connectivity and functional connectivity dynamics derived from empirical fMRI data. The fMRI time series data hasn't been made publicly available yet, and the procedure is at this stage demonstrated on simulated data. 30 - 27 +1. The neural mass model by Montbrio, Pazo and Roxin 28 +1. Construction of the TVB model for a particular subject 29 +1. Dynamics of the model, and execution of a parameter study 30 +1. Summary of the simulation results for the whole cohort 31 31 32 - == Virtual ageingtrajectories: 1000BRAINScohort==32 +Link to the notebook: 33 33 34 - (%style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal;font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Beyond the generalcommonarchitecture, the humanbrainischaracterized by a high interindividual variability with regardtoits structureand functionalabilities, including measurablecognitive outcome.Disentangling the sourcesand consequences of thisvariability is key to understanding the capabilities of our brains and any pathologies occurringover the lifespan. This alsoincludes implementing measures of variability intosimulationsand modellingapproachesto makethem biologicallyplausible and as realistic as possible.34 +* [[virtual_ageing/notebooks/1_BNM_for_resting_state.ipynb>>https://lab.ch.ebrains.eu/user-redirect/lab/tree/shared/SGA3%20D1.2%20Showcase%201/virtual_ageing/notebooks/1_BNM_for_resting_state.ipynb]] 35 35 36 -(% style="line-height:1.38; margin-top:13px" %) 37 -(% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)The aging brain is a particularly remarkable use case in this respect as the interindividual variability of brains and cognitive abilities of older subjects from the general population is very pronounced. The relevant factors influencing this variability, be it genetics or environmental and lifestyle factors, are manifold and barely understood yet. Similarly, the different levels within the organization of the brain, from the molecular, cellular to the systems level, contribute to these effects to varying degrees. The aim of the first branch of Showcase 1 is thus to model brain aging with biologically plausible assumptions about the architecture of the brain, using the EBRAINS platform and integrating information from the different organizational levels of the brain, and to create a virtually aged cohort of brain models which allow testing of hypotheses and causal linkage of potential sources and effects of the empirically observed variability. 36 +[[image:image-20220103100841-2.png]] 38 38 39 -== Brainregion variance:incorporating receptordensities ==38 +== Virtual ageing trajectories == 40 40 41 - (% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)The secondbranch of the Showcase 1 focuses ontheimpact of variability of the propertiesof brain regionson the expressed dynamics. Over the last twodecades,whole-brain network modelshave proven useful instruments to describe thebrain's resting-state activity: from explainingthe intrinsic dynamical behavior ofthe brain to the classification of brain states in disorders of consciousness. These whole-brain modelsarebuilt at the resolutionof interconnected cortical regionsand subcortical brain areas, with each region simulated at the population levels. So far, a major limitation of these models lies in the assumption that all brain regions are of identical characteristics while it is well-known that brain areas differ in a varietyofproperties,e.g., neuronal densities, local cytoarchitecture,and typesof neuroreceptors [Deco2021].Accountingforthese regional variancesiscrucial for translational purposes as for example differences in neuroreceptor densities determine the impact of pharmacological agents on particular brain regions and thus their potential to modulate the whole-brain dynamics. The purpose of Showcase #1(b) is,therefore, to illustrate howwhole-brainnetwork models can be adapted to include suchregionalvariances and to develop workflows to run the simulations takingfull advantageof the HBP's EBRAINSinfrastructure, leading toworkflowsthat are accessible and re-usable by the scientific community.40 +The second steps shows the investigation of virtual ageing trajectory for each subject. In this context, we are going to show 42 42 43 -(% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)In implementation of Showcase 1b, the simulation is based on a network of nodes that represent brain ROI, each running the (% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:700; text-decoration:none; white-space:pre-wrap" %)**BEI**(% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %) (Balanced Excitation-Inhibition) model [Deco2014], which defines two neuronal subpopulations, an excitatory and an inhibitory one, both interacting through neurochemical (e.g., AMPA, GABA, NMDA, etc.) currents. The objective of the Showcase 1b is to demonstrate and find out the more precise mechanism through which regional neurotransmitter density affects this excitation-inhibition balance. Numerically, the goal is to minimize the difference in sliding window Functional Connectivity Dynamics ((% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:700; text-decoration:none; white-space:pre-wrap" %)**swFCD**(% style="color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)) between a reference empirical signal and a simulated one. The swFCD subdivides the time-series into successive windows and, for each one, computes its corresponding Functional Connectivity through the usual Pearson correlation, resulting in a series of NxN matrices. Two swFCD can be compared by means of the Kolmogorov-Smirnov statistic. 42 +1. What we mean by virtual ageing and what is the empirical basis to investigate this approach 43 +1. How we can virtually age a subject using whole-brain modelling 44 +1. How the increase structure-function relationship relates to virtual ageing 44 44 45 - 46 +Link to the notebook: 47 + 48 +* [[virtual_ageing/notebooks/2_virtual_ageing_trajectories.ipynb>>https://lab.ch.ebrains.eu/user-redirect/lab/tree/shared/SGA3%20D1.2%20Showcase%201/virtual_ageing/notebooks/2_virtual_ageing_trajectories.ipynb]] 49 + 50 +[[image:image-20220103101022-3.png]] 51 + 52 +== Inference with SBI == 53 + 54 +Last step of the inter-individual variability workflow employs Simulation Based Inference for estimation of the full posterior values of the parameters. Here, a deep neural estimator is trained to provide a relationship between the parameters of a model (black box simulator) and selected descriptive statistics of the observed data. 55 + 56 +[[image:image-20220103104332-4.png||height="418" width="418"]] 57 + 58 +Link to the notebook: 59 + 60 +* [[virtual_ageing/notebooks/3_inference_with_SBI.ipynb>>https://lab.ch.ebrains.eu/user-redirect/lab/tree/shared/SGA3%20D1.2%20Showcase%201/virtual_ageing/notebooks/3_inference_with_SBI.ipynb]] 61 + 62 +== Regional variability data == 63 + 64 +The first step of the regional variability workflow loads the data from the Knowledge Graph and defines the regional bias on the model. In this case we require: 1) structural connectivity matrices, 2) GABA and AMPA receptor densities at each region, and 3) empirical resting-state fMRI data for fitting and validation of the simulations. The three datasets shall be characterised in the same parcellation. 65 + 66 +Link to the notebook: 67 + 68 +* [[regional_variability/notebooks/1_data_setup.ipynb>>https://lab.ch.ebrains.eu/user-redirect/lab/tree/shared/SGA3%20D1.2%20Showcase%201/regional_variability/notebooks/1_data_setup.ipynb]] 69 + 70 +(% style="text-align:center" %) 71 +[[image:image-20220103095424-1.png]] 72 + 73 +== Fitting model parameters for models with regional bias == 74 + 75 +A series of simulations of the whole-brain network model is launched in the EBRAINS HPC facilities in order to identify the optimal model parameters leading to simulated resting-state brain activity that best resembles the empirically observed activity. 76 + 77 +Link to the notebook: 78 + 79 +* [[regional_variability/notebooks/2_parameter_swep_proto.ipynb>>https://lab.ch.ebrains.eu/user-redirect/lab/tree/shared/SGA3%20D1.2%20Showcase%201/regional_variability/notebooks/2_parameter_swep_proto.ipynb]] 80 + 81 +[[image:image-20220103095948-1.png]] 46 46 ))) 47 47 48 48
- image-20220103095424-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.fousekjan - Size
-
... ... @@ -1,0 +1,1 @@ 1 +33.7 KB - Content
- image-20220103095948-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.fousekjan - Size
-
... ... @@ -1,0 +1,1 @@ 1 +4.1 KB - Content
- image-20220103100841-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.fousekjan - Size
-
... ... @@ -1,0 +1,1 @@ 1 +116.4 KB - Content
- image-20220103101022-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.fousekjan - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.1 KB - Content
- image-20220103104332-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.fousekjan - Size
-
... ... @@ -1,0 +1,1 @@ 1 +50.6 KB - Content