BioExplorer

KO | EN

gitlite — search

#hacktoberfest #typescript #go #golang #rust #linux #nodejs #java #kubernetes #awesome-list #pytorch #mcp #ios #openai

(★ 68)

The Blue Brain BioExplorer (BBBE) is a tool for data visualization experts and scientists to extract and analyze scientific data from visualization and interactive exploration

BioExplorer Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Blue Brain BioExplorer

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_banner.png)

## Description

Exploration relies on building software that combines data integration, analysis and interactive visualization to build, modify and navigate through large scientific datasets. For this, Blue Brain built and open-sourced the Blue Brain BioExplorer. The Blue Brain BioExplorer (BBBE), which started as an internal project, is now open source. It
was originally developed to answer key scientific questions related to the Coronavirus as a use case and to deliver a visualization tool. Today, the _BBBE_ allows to reconstruct, visualize, explore and describe in detail the structure and function of highly-detailed biological structures such as molecular systems, neurons, astrocytes, blood vessels, and more. You can see the first application of the _BBBE_ in '[A Machine-Generated View of the Role of Blood Glucose Levels in the Severity of COVID-19](https://www.frontiersin.org/articles/10.3389/fpubh.2021.695139/full?utm_source=fweb&utm_medium=nblog&utm_campaign=ba-sci-fpubh-covid-19-elevated-blood-glucose-blue-brain)' study, and see the SARS-COV-2 coronavirus as you have never seen it before by clicking on the following image!

On the third anniversary of the first lock-down, we look back at how #MachineLearning helped reveal the role of blood glucose levels in the severity of COVID-19. Imagine what else could be tackled with OpenScience.

## An extended and improved CCFv3 annotation

The Blue Brain Project presents the first comprehensive mouse brain atlas based on the Allen Institute’s Common Coordinate Framework version 3. This atlas includes anatomical Nissl reference data that has been precisely aligned within this reference space, providing the scientific community with a crucial tool for automated and accurate mapping of a wide range of histological slices or volumes of the mouse brain. We have also integrated additional layers, such as the spinal cord, barrel columns, as well as the granular and molecular layers in the cerebellum. This allowed us to create an enhanced version of our cell atlas, mapping every cell in the mouse brain by location, region, and type. From this data, properties such as neuron soma and morphology can be derived, paving the way for increasingly accurate simulation models.

* [An extended and improved CCFv3 annotation and Nissl atlas of the entire mouse brain](https://www.biorxiv.org/content/10.1101/2024.11.06.622212v1)

## The Harvard Brain

Do you want want to know more about the full story? Read the [Studies In Silico: An Interview With Cyrille Favreau On EPFL’s Blue Brain Project](http://www.theharvardbrain.com/spring-2023-8203lara-ota-buse-toksoumlz-and-kei-hayashi.html).

## Social Media

* [Blue Brain BioExplorer 1.6 goes RTX!](https://www.linkedin.com/feed/update/urn:li:activity:7057015980253696000/)
* [On the third anniversary of the first lockdown, we look back at how Machine Learning helped reveal the role of blood glucose levels in the severity of COVID-19.](https://www.linkedin.com/posts/blue-brain-project_machine-learning-and-understanding-the-role-activity-7044953592570535937-s6IB?utm_source=share&utm_medium=member_desktop)
* [If you’re traveling to Spain over the holiday break, don’t miss the amazing exhibition Brain(s) opening soon in Madrid featuring images from the EPFL Blue Brain Project. Join the more than 86'000 visitors who already enjoyed it while on its Barcelona stop!](https://www.linkedin.com/posts/blue-brain-project_if-youre-traveling-to-spain-over-the-holiday-activity-7009472054114533376-Serk?utm_source=share&utm_medium=member_desktop)
* [The BlueBrainBioExplorer 1.4 is now out and ready to explore additional bio assemblies from neurons and astrocytes to vasculatures and more!](https://www.linkedin.com/posts/blue-brain-project_openscience-neuroscience-scientificvisualization-activity-6980420229633867776-ViVr?utm_source=share&utm_medium=member_desktop)
* [The EPFL Blue Brain Project will be featuring in the exciting Brain(s) exhibition at the Barcelona Centre of Contemporary Culture starting tomorrow!](https://www.linkedin.com/posts/blue-brain-project_cervellscccb-cerebroscccb-brainscccb-activity-6957702754731450369-gsLV?utm_source=share&utm_medium=member_desktop)
  
## BioExplorer at PASC 2023

<div align="center">
<img src="https://www.pasc-conference.org/wp-content/uploads/2022/07/PASC_23_2.jpg" width="25%" height="25%" alt="Image" />
</div>
On the 27th of June 2023, the Blue Brain BioExplorer was presented at the PASC23 conference in Davos (Switzerland), as part of the *MS4E - Scientific Visualization of Big Data*
 minisymposium: [Visual Scientific Exploration at Blue Brain, and Beyond](https://pasc23.pasc-conference.org/presentation/?id=msa164&sess=sess168)

## BioExplorer goes RTX!

BioExplorer now benefits from [NVIDIA OptiX](https://developer.nvidia.com/rtx/ray-tracing/optix) backend compatibility, allowing it to fully utilize the NVIDIA RTX acceleration hardware capabilities for fast and high-quality rendering of scientific datasets. This advanced feature, along with the new stereo perspective camera, enables virtual reality use-cases with pure ray-tracing. Additionally, an AI-powered denoiser has been incorporated to enhance the real-time rendering quality.

Simply add the OptiX engine command line argument when starting the _BBBE_.
```bash
service --engine optix6 --plugin BioExplorer
```

Note that, in order to offer the best experience on local desktops, the _BBBE_ now also has a native viewer.
```bash
viewer --engine optix6 --plugin BioExplorer
```

## At the museum

July 2022: The EPFL Blue Brain Project is featuring in the exciting [Brain(s) exhibition](https://www.cccb.org/en/exhibitions/file/brains/237851) at the Barcelona Centre of Contemporary Culture at the Fundación Telefónica Madrid.

The Blue Brain images on show were created with the _BBBE_. Checkout the [news article](https://actu.epfl.ch/news/blue-brain-images-on-show-at-the-brains-exhibition/) for more information.

## Architecture

The _BBBE_ application is built on top of a fork of [Blue Brain Brayns](https://github.com/BlueBrain/Brayns/releases/tag/1.0.0) 1.0.0 , the Blue Brain rendering platform. The _BBBE_ uses the underlying technical capabilities of the rendering platform to create large scale and accurate 3D scenes from Jupyter notebooks.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/architecture.png)

More information can be found in the [architecture](./ARCHITECTURE.md) documentation.

## General components

### Assemblies

Assemblies are groups of biological elements, such as proteins, membranes, glycans, etc. As an example, a virion is made of a lipid membrane, spikes proteins, an RNA sequence, etc, and all those elements belong to the same object. That’s why they need to belong to the same container, the assembly. Assemblies can have different shapes: Sphere, Cube, etc, that are automatically generated according to the parameters of individual components.

### Proteins

Proteins are loaded from PDB files. Atoms, non-polymer chemicals and bonds can be loaded and displayed in various color schemes: chain id, atom, residue, etc.
Proteins also contain the amino acid sequences of the individual chains. Sequences that can be used to query glycosylation sites, or functional regions of the protein.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_proteins_banner.png)

### Glycans

Glycans are small proteins that are attached to an existing protein of the assembly. Individual glycan trees are loaded from PDB files and attached to the glycosylation sites of the specified protein. By default, glycans are attached to all available glycosylation sites, but a set of specific sites can be specified.

Glycan trees models located in the python sdk test folder were generated with [Glycam Builder](http://glycam.org).

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_glycans_banner.png)

### RNA sequence

An RNA sequence can be loaded from a text sequence of codons. Various shapes can be selected to represent the RNA sequence: Trefoil knot, torus, star, etc. This allows the sequence to be efficiently packed into a given volume. A different color is assigned per type of codon.

### Mesh-based membranes

Mesh-based membranes create membranes based on 3D meshes. This allows the construction of complex membranes where mesh faces are filled with proteins.

### Virus

A viral particle is an assembly consisting of a membrane, an RNA sequence, and a given number of S, M and E proteins. The virus has a predefined spherical shape defined by its radius. The default parameters for the virus are a radius of 45 nanometers, 62 S proteins, 42 E proteins, and 50 M proteins. Dimensions and concentrations were retrieved from the literature.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_coronavirus_banner.png)

### Membrane

A membrane is an assembly of phospholipids. Phospholipids structures are created following the process described in the [VMD](https://www.ks.uiuc.edu/Research/vmd) Membrane Proteins [tutorial](http://www.ks.uiuc.edu/Training/Tutorials). The assembly itself is generated by the BioExplorer, for a given shape, and a number of instances of phospholipids.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_membrane_banner.png)

### Vasculature

Vasculatures are loaded from the database (see the database [schema](./storage/database/04_bioexplorer_vasculature_schema.sql) and the example [notebook](./bioexplorer/pythonsdk/notebooks/vasculature/BioExplorer_import_sonata_to_db.ipynb) for loading data from [Sonata](https://github.com/AllenInstitute/sonata) files). A vasculature is defined by the blood vessels or arrangement of blood vessels in an organ or part.

```python
vasculature_model = bio_explorer.add_vasculature(
    assembly_name='Vasculature', population_name='vasculature', use_sdf=True)
```

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_vasculature_banner.png)

An example dataset can be downloaded from the [Blue Brain Neuro-Glia-Vasculature Portal](https://bbp.epfl.ch/ngv-portal/anatomy/experimental-data/)

References:
* [Brain microvasculature has a common topology with local differences in geometry that match metabolic load](https://www.cell.com/neuron/fulltext/S0896-6273(21)00080-5?_returnURL=https%3A%2F%2Flinkinghub.elsevier.com%2Fretrieve%2Fpii%2FS0896627321000805%3Fshowall%3Dtrue)
* [Blue Brain Neuro-Glia-Vasculature Portal. Vasculature. Reconstruction Data](https://bbp.epfl.ch/ngv-portal/#explore)

### Neurons

Circuits of neurons are loaded from the database (see the database [schema](./storage/database/02_bioexplorer_neurons_schema.sql) and the example [notebook](./bioexplorer/pythonsdk/notebooks/neurons/BioExplorer_import_sonata_to_db.ipynb) for loading data from [Sonata](https://github.com/AllenInstitute/sonata) files) using their position and orientation. Each cell is composed of sections that form the axons and dendrites, as well as spines. Cell internals such as the nucleus and the mitochondria can be automatically generated, according to the data provided by the scientific literature. The _BBBE_ also implements procedural generation of varicosities along the axon, as well as myelin sheaths.

```python
status = bio_explorer.add_neurons(
    assembly_name='Neurons',
    population_name='neurons',
    realism_level=be.MORPHOLOGY_REALISM_LEVEL_ALL,
    synapses_type=be.NEURON_SYNAPSES_AFFERENT, generate_varicosities=True,
    generate_internals=True, generate_externals=True
)
```

An [example dataset](https://zenodo.org/record/6906785#.Ywym7tVBxH6) is available in the [Model of Rat Non-barrel Somatosensory Cortex Anatomy](https://www.biorxiv.org/content/10.1101/2022.08.11.503144v1) publication. Please refer to the documentation of the [Sonata](https://github.com/AllenInstitute/sonata) format for information on how to load and analyze the model. A [jupyter notebook](./bioexplorer/pythonsdk/notebooks/neurons/rat_non-barrel_somatosensory_cortex_anatomy/BioExplorer_rat_non-barrel_somatosensory_cortex_anatomy.ipynb) has been included with basic examples of how to explore the data using the Blue Brain open-source packages [NeuroM](https://neurom.readthedocs.io/en/stable/) and [Blue Brain SNAP](https://bluebrainsnap.readthedocs.io/en/stable/).

References:
* [A Model of Rat Non-barrel Somatosensory Cortex Anatomy](https://www.biorxiv.org/content/10.1101/2022.08.11.503144v1)
* [A simplified morphological classification scheme for pyramidal cells in six layers of primary somatosensory cortex of juvenile rats](https://www.sciencedirect.com/science/article/pii/S2451830118300293)
* [Age and sex do not affect the volume, cell numbers, or cell size of the suprachiasmatic nucleus of the rat: An unbiased stereological](https://doi.org/10.1002/cne.903610404)
* [Community-based Reconstruction and Simulation of a Full-scale Model of Region CA1 of Rat Hippocampus](https://www.biorxiv.org/content/10.1101/2023.05.17.541167v1)
* [Modeling and Simulation of Neocortical Micro- and Mesocircuitry. Part II: Physiology and Experimentation](https://www.biorxiv.org/content/10.1101/2023.05.17.541168v2)
* [Community-based reconstruction and simulation of a full-scale model of the rat hippocampus CA1 region](https://journals.plos.org/plosbiology/article?id=10.1371/journal.pbio.3002861)

### Astrocytes

Circuits of astrocytes are loaded from the database (see the database [schema](./storage/database/03_bioexplorer_astrocytes_schema.sql) and the example [notebook](./bioexplorer/pythonsdk/notebooks/astrocytes/BioExplorer_import_sonata_to_db.ipynb) for loading data from [Sonata](https://github.com/AllenInstitute/sonata) files) using their position and orientation. Astrocytes end-feet are connected to the vasculature using data stored in a dedicated connectome database [schema](./storage/database/05_bioexplorer_connectome_schema.sql). The _BBBE_ allows end-feet to automatically adapt to the vasculature vessel size.

```python
vasculature_model = be.add_astrocytes(
    assembly_name='Astrocytes', population_name='astrocytes', use_sdf=True)
```

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_neurons_banner.png)

The neurons assembly allows visualization of brain microcircuits. Morphologies imported from ASC, SWC or H5 files into the _BBBE_ database can be loaded an transformed in different ways: simple spheres or somas only, simple rendering of full morphologies using spheres, cones and cylinders, or advanced rendering of full morphologies using the [signed distance field](https://iquilezles.org/articles/distfunctions/) technique.

Multi-scale models of the rat and mouse brain integrate models of ion channels, single cells, microcircuits, brain regions, and brain systems at different levels of granularity (molecular models, morphologically detailed cellular models, and abstracted point neuron models). A neuronal microcircuit is the smallest functional ecosystem in any brain region that encompasses a diverse morphological and electrical assortment of neurons, and their synaptic interactions. Blue Brain has pioneered data-driven digital reconstructions and simulations of microcircuits to investigate how local neuronal structure gives rise to global network dynamics. These methods could be extended to digitally reconstruct microcircuits in any brain region.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/microcircuit.png)

In the nervous system, a synapse is a structure that permits a neuron (or nerve cell) to pass an electrical or chemical signal to another neuron. Synapses can be classified by the type of cellular structures serving as the pre- and post-synaptic components. The vast majority of synapses in the mammalian nervous system are classical axo-dendritic synapses (an axon connecting to a dendrite).

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/synapses.png)

An example dataset is available on the [Blue Brain Neuro-Glia-Vasculature Portal](https://bbp.epfl.ch/ngv-portal/anatomy/experimental-data/)

References:
* [Thalamic control of sensory enhancement and sleep spindle properties in a biophysical model of thalamoreticular microcircuitry](http://biorxiv.org/lookup/doi/10.1101/2022.02.28.482273)
* [Computational synthesis of cortical dendritic morphologies](https://doi.org/10.1016/j.celrep.2022.110586)
* [Digital reconstruction of the neuro-glia-vascular architecture](https://doi.org/10.1093/cercor/bhab254)
* [Blue Brain Neuro-Glia-Vasculature Portal. Anatomy. Reconstruction Data](https://bbp.epfl.ch/ngv-portal/anatomy/reconstruction-data/)
* [The SONATA data format for efficient description of large-scale network models](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1007696)

* [Cortical cell assemblies and their underlying connectivity: an in silico study](https://www.biorxiv.org/content/10.1101/2023.02.24.529863v1)
* [Modeling and Simulation of Neocortical Micro- and Mesocircuitry. Part II: Physiology and Experimentation](https://www.biorxiv.org/content/10.1101/2023.05.17.541168v1)

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/synapses2.png)

### Spinal cord

The spinal cord is an elongated nervous structure that together with the brain forms the central nervous system. It relays sensory and motor information between the brain and the body, thus controlling most somatic and autonomic body functions. In recent years, great progress has been made in creating digital atlases for the mouse brain, covering regions, cell composition and connectivity. For the spinal cord, however, such atlases do not yet exist. In this dissertation, I present the first versions of high-resolution 3D atlases of the spinal cords for five mammalian species: mouse, rat, marmoset, rhesus monkey, and human. First, I summarize the current state of the efforts to understand the spinal cord and its organization principles from anatomy (cytoarchitecture) to cell classifications and connectome principles. I then describe how the different properties of the spinal cord can help us in reconstructing the various spinal structures. Next, I present a workflow for data-driven reconstruction that can be used to create 3D models of the spinal cord of any species based on available annotated 2D microscopy images. I used data from Sengul, Watson, et al., 2012 to generate 3D reference volumes of the cytoarchitecture of the 5 mammalian species: mouse, rat, marmoset, rhesus monkey and human. Every 3D reference volume model comprises six levels of the spinal cytoarchitecture and defines their locations, shapes, and volumes. This allows us to compare the spinal cord of these 5 species. I find that all reconstructed spinal cords are remarkably similar, showing far fewer differences than the brains of the respective species. For the mouse spinal cord, I use data from the Allen Institute for Brain Science to generate a cell atlas for the three major spinal cell types: interneurons, motoneurons, and glial cells. The mouse spinal cell atlas comprises the densities and positions of 11,7 million cells in total with 2.7 million interneurons, about 31 thousand motoneurons, and 9.0 million glial cells. Next, I discuss how recent transcriptomic data can be used to assign a gene expression profile to each neuron in the spinal cell atlas. I present a preliminary analysis of RNA-sequencing and in situ RNA hybridization data aiming to develop a workflow for labeling of spinal cells with appropriate transcriptome profiles. Finally, I summarize the results of my dissertation as well as consequences and limitations of the underlying assumptions. This discussion ends with an outlook for how the atlas can be developed further in the future.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_spinal_cord_banner.png)

References:
* [Digital reconstruction of the mammalian spinal cord: from anatomical reference volume to cell type atlas of the mouse spinal cord](https://infoscience.epfl.ch/record/302106)

### Simulation of neuronal activity

Using the NEURON simulation package, the circuit information is loaded from disk, instantiating the various cell models (morphologies with ion channel distribution) and synaptic connections. The experimenter selects a stimulus protocol which will inject electrical current into the network and increase the membrane voltages of cells. As cells approach a threshold current, they release an action potential (AP) which will then propagate additional current changes to other cells via the synapses' release mechanisms. _BBBE_ loads the simulation reports generated by NEURON and maps the voltages to the corresponding segments of the morphologies. A transfer function defines the mapping between a color and a voltage value.

### Morphology synthesis

The goal of [computational synthesis of cortical dendritic morphologies](https://www.sciencedirect.com/science/article/pii/S2211124722003308) is to be able to generate an arbitrary number of neurons (and also other cells, such as glia) that can be subsequently used in various types of simulation. Part of this goal is to recreate in the synthesized cells as many morphological features as possible.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/synthesis.png)

The synthesis scheme is based on the assumption that it is necessary to know the environment within which the cells are growing in order to recreate them accurately. Neuronal morphologies are influenced both by the embedding space and the presence of other cells. Their axons may target certain regions or the dendrites may mass in one region to collect input, such as the apical tuft of pyramidal cells. It is important therefore to synthesize the cells within biologically accurate volumes.

### Proximity detection

In the context of brain simulation, detecting touches between neurons is a essential part of the process. The _BBBE_ provides a renderer that computes the distance between the geometries in the 3D scene.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/touchdetection.png)

When a ray hits a geometry, a random secondary ray is sent in a direction belonging to an hemisphere defined by the normal to the surface. If that secondary ray hits another geometry, the distance between the initial hit and the new intersection is computed, and the corresponding color is assigned to the pixel. By default, red is for short distances (including touches), and green for longer ones. The notion of short and long is defined in the settings of the renderer.

### White matter and tractography

#### White matter

White matter is composed of bundles, which connect various grey matter areas (the locations of nerve cell bodies) of the brain to each other, and carry nerve impulses between neurons. Myelin acts as an insulator, which allows electrical signals to jump, rather than coursing through the axon, increasing the speed of transmission of all nerve signals.

A [Python notebook example](./bioexplorer/pythonsdk/notebooks/connectomics/BioExplorer_import_white_matter_allen_brain.ipynb) demonstrates how to download and import white matter streamlines from the [Allen Brain Institute website](https://alleninstitute.org) into the _BBBE_ database. Another [Python notebook](./bioexplorer/pythonsdk/notebooks/connectomics/BioExplorer_white_matter.ipynb) demonstrates how to visualize the streamlines with the _BBBE_.

```python
white_matter_model = be.add_white_matter(
    assembly_name='White matter',  population_name='connectome', radius=2.5)
```

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/white_matter.png)

References:
* [Allen Brain Institute: mouse connectivity projections](http://connectivity.brain-map.org/)
* [Allen Brain Institute: mouse connectivity atlas](https://alleninstitute.github.io/AllenSDK/connectivity.html)

The white matter feature contributed to generating images for the [null model of the mouse whole-neocortex micro-connectome](https://www.nature.com/articles/s41467-019-11630-x) publication and produce the corresponding movie.

##### Tractography

Tractography is a neuroimaging technique used in the field of neuroscience and medical imaging to visualize and study the white matter pathways in the human brain. White matter consists of bundles of nerve fibers (axons) that connect different regions of the brain and enable communication between them. Tractography helps researchers and clinicians map and understand these complex neural pathways.

The basic principle of tractography involves tracking the diffusion of water molecules in brain tissue. This technique is often referred to as diffusion-weighted magnetic resonance imaging (DW-MRI) or diffusion tensor imaging (DTI). Here's how it works:

1. Diffusion of Water Molecules: Water molecules in brain tissue naturally diffuse in a preferred direction along the axonal fibers in white matter. This diffusion is hindered by cellular structures, membranes, and myelin sheaths surrounding axons.

2. Imaging Process: During a DW-MRI scan, multiple images are acquired with different gradients of magnetic fields, which allows for the measurement of water diffusion in multiple directions within each voxel (3D pixel) of the brain.

3. Data Analysis: The data from DW-MRI is processed to calculate a diffusion tensor, which provides information about the direction and magnitude of water diffusion in each voxel. From this information, researchers can infer the orientation of axonal fibers in that region.

4. Tractography Reconstruction: Tractography algorithms use the diffusion tensor information to reconstruct and visualize the trajectories of white matter pathways throughout the brain. This results in colorful images and 3D representations that show the connections between different brain regions.

Tractography has numerous applications in neuroscience and clinical practice. Researchers use it to study brain connectivity, understand the organization of neural circuits, and investigate neurological disorders. In the clinical setting, tractography can help surgeons plan brain surgeries, evaluate the extent of brain lesions, and assess the impact of brain injuries or diseases on white matter pathways. It has also been used to study conditions like Alzheimer's disease, multiple sclerosis, and stroke.

Different variations of tractography algorithms have been developed to improve the accuracy of tracking neural pathways, such as deterministic tractography and probabilistic tractography. Overall, tractography is a valuable tool for advancing our understanding of brain structure and function.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/tractography.png)

A [Python notebook example](./bioexplorer/pythonsdk/notebooks/tractography/BioExplorer_ISMRM_2015_Tracto_challenge_ground_truth_bundles_TRK_v2.ipynb) demonstrates how to download streamlines from the [Tractography Challenge ISMRM 2015](https://zenodo.org/record/572345) dataset and visualize them in the _BBBE_.

References:
* [Tractography Challenge ISMRM 2015](https://zenodo.org/record/572345)

### Enzyme reactions

An enzyme attracts substrates to its active site, catalyzes the chemical reaction by which products are formed, and then allows the products to dissociate (separate from the enzyme surface). The combination formed by an enzyme and its substrates is called the enzyme–substrate complex. The _BBBE_ allows easy visualization of enzyme reactions by providing a substrate, a product, and a type of reaction (for example: [Hexokinase](./bioexplorer/pythonsdk/notebooks/molecular_systems/BioExplorer_enzyme_reaction.ipynb)).

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_enzyme_reactions_banner.png)

References:
* [Blue Brain Project Neuro-Glia-Vasculature Portal](https://bbp.epfl.ch/ngv-portal/)
* [Blue Brain Neuro-Glia-Vasculature Portal. Metabolism. Reconstruction Data](https://bbp.epfl.ch/ngv-portal/#explore)
* [Breakdown and rejuvenation of aging brain energy metabolism](https://www.biorxiv.org/content/10.1101/2023.08.30.555341v1)

### Neuromodulation

Neuromodulation of neocortical microcircuits is one of the most fascinating and mysterious aspects of brain physiology. Despite over a century of research, the neuroscientific community has yet to uncover the fundamental biological organizing principles underlying neuromodulatory release. Phylogenetically, Acetylcholine (ACh) is perhaps the oldest neuromodulator, and one of the most well-studied. ACh regulates the physiology of neurons and synapses, and modulates neural microcircuits to bring about a reconfiguration of global network states. ACh is known to support cognitive processes such as learning and memory, and is involved in the regulation of arousal, attention and sensory processing. While the effects of ACh in the neocortex have been characterized extensively, integrated knowledge of its mechanisms of action is lacking. Furthermore, the ways in which ACh is released from en-passant axons originating in subcortical nuclei are still debatable. Simulation-based paradigms play an important role in testing scientific hypotheses, and provide a useful framework to integrate what is already known and systematically explore previously uncharted territory. Importantly, data-driven computational approaches highlight gaps in current knowledge and guide experimental research. To this end, I developed a multi-scale model of cholinergic innervation of rodent somatosensory cortex comprising two distinct sets of ascending projections implementing either synaptic (ST) or volumetric transmission (VT). The model enables the projection types to be combined in arbitrary proportions, thus permitting investigations of the relative contributions of these two transmission modalities. Using our ACh model, we find that the two modes of cholinergic release act in concert and have powerful desynchronizing effects on microcircuit activity. Furthermore we show that this modeling framework can be extended to other neuromodulators, such as dopamine and serotonin, with minimal constraining data. In summary, our results suggest a more nuanced view of neuromodulation in which multiple modes of transmitter release - ST vs VT - are required to produce synergistic functional effects.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/notebooks/bioexplorer_neuromodulation_banner.png)

References:
* [Neuromodulation of neocortical microcircuitry: a multi-scale framework to model the effects of cholinergic release](https://infoscience.epfl.ch/record/294819)
* [The cholinergic innervation develops early and rapidly in the rat cerebral cortex: a quantitative immunocytochemical study](https://www.sciencedirect.com/science/article/abs/pii/S030645220100389X)

# Extensions

The _BBBE_ represents a highly adaptable and flexible system tailored to explore a wide array of scientific datasets. This exceptional platform has been engineered to accommodate a diverse range of data sources and formats. Its extensibility lies in the incorporation of plugins, which serve as add-on modules expanding the system's capabilities.

Among the plugins available in the extensions folder, there are dedicated modules catering to specific scientific domains. For instance, the cosmology plugin empowers researchers to delve into and analyze astronomical datasets. On the other hand, the medical imaging plugin facilitates in-depth investigations of medical datasets, making it possible for healthcare professionals and scientists to examine and interpret various types of medical images with remarkable precision.

Beyond these examples, _BBBE_ boasts the potential to accommodate additional plugins, making it a powerful platform for scientists from diverse disciplines to explore and make sense of complex scientific data efficiently and effectively.

## Space explorer

Scientific visualization plays a vital role in the field of space exploration by enabling researchers to interpret and communicate complex astronomical data in a visually compelling manner. It involves the use of advanced computer graphics techniques to transform raw data collected from telescopes, satellites, and spacecraft into visually stunning and informative representations. Through scientific visualization, astronomers can create accurate and detailed models of celestial objects, such as galaxies, nebulae, and planetary systems, aiding in the understanding of their formation, evolution, and behavior. It allows scientists to explore and analyze vast datasets, unveiling patterns, relationships, and hidden structures that may otherwise go unnoticed. Additionally, scientific visualization serves as a powerful tool for public outreach, engaging and inspiring the general public by presenting the awe-inspiring beauty and scientific discoveries of the cosmos in accessible and captivating ways. Overall, scientific visualization plays a crucial role in advancing our knowledge of the universe and fostering a deeper appreciation for the wonders of space exploration.

### Black holes

The port of [Shadertoy](https://www.shadertoy.com)'s black hole implementation to the _BBBE_ represents an exciting fusion of artistic creativity and scientific exploration. Shadertoy, a popular platform for shader development and visual effects, offers a stunning black hole simulation that captures the mesmerizing visual aspects of these cosmic entities. The integration of Shadertoy's black hole into the _BBBE_ allows users to engage with the visualization in a more immersive and scalable way.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/extensions/cosmology/docs/blackhole_banner.png)

References:
* Shadertoy's [Black hole with accretion disk](https://www.shadertoy.com/view/tsBXW3)
* [Example notebook](./extensions/cosmology/notebooks/Gaia_ESA.ipynb) for visualizing the GAIA ESA archive dataset

## Medical Imaging Explorer

Medical imaging is a vital component of modern healthcare, enabling healthcare professionals to visualize internal structures and diagnose various medical conditions.

### DICOM

DICOM stands for "Digital Imaging and Communications in Medicine." It is a widely used standard for the storage, transmission, and sharing of medical images and related information in the healthcare industry. DICOM was created by the National Electrical Manufacturers Association ([NEMA](https://www.nema.org)) and the American College of Radiology ([ACR](https://www.acr.org)) to ensure interoperability and compatibility among various medical imaging devices and software.

The _BBBE_ DICOM plugin implements the loading of DICOM datasets.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/extensions/medicalimaging/docs/dicom_banner.png)

## Environment

Visualizing environmental data holds immense significance in understanding and addressing complex environmental challenges. By transforming vast datasets into clear, graphical representations, we can grasp the intricate interactions between various environmental factors.

### Geological data

Visualizing geological data is of paramount importance in the field of geology as it provides a powerful means to comprehend and interpret complex information. By converting raw data into visually appealing representations, geologists gain a deeper understanding of the Earth's composition, structure, and processes. Maps, cross-sections, and 3D models enable researchers to identify patterns, trends, and anomalies that may remain obscured in raw datasets. Visualization aids in making informed decisions related to resource exploration, hazard assessment, and environmental management. Moreover, presenting geological findings visually enhances communication with colleagues, policymakers, and the public, fostering greater awareness and support for geological research and its implications for society. The _BBBE_ serves as an indispensable tool in unraveling the mysteries of our planet and harnessing its resources responsibly.

* [Example notebook](./extensions/environment/notebooks/Charm-50.ipynb) for visualizing the [InfoTerre](http://infoterre.brgm.fr/) dataset

## Physics

### Nuclear fusion

The core challenge lies in modeling the behavior of superheated plasma, the fuel for this revolutionary energy source. To simulate this complex phenomenon, the plasma is envisioned as an array of particles, with each particle intricately characterized by its position and direction. The direction vector of each particle not only represented its position but also served as a direct indicator of the particle's charge, a crucial factor in the fusion reaction.

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/extensions/physics/nuclearfusion/notebooks/nuclearfusion_banner.png)

* [Example notebook](./extensions/physics/nuclearfusion/notebooks/NuclearFusion.ipynb)

## Python SDK

A simple API if exposed via the _BBBE_ python library. The API allows scientists to easily create and modify assemblies, according the biological parameters. The _BBBE_ programming language is not necessarily reflecting the underlying implementation, but is meant to be as simple as close as possible to the language used by the scientists to describe biological assemblies.

The _BBBE_ Python SDK is available on [pypi](https://pypi.org/project/bioexplorer/).

A large number of examples (as python notebooks) are provided in the [notebooks](https://github.com/BlueBrain/BioExplorer/tree/master/bioexplorer/pythonsdk/notebooks) folder.

## Documentation

See [here](https://bluebrain.github.io/BioExplorer/) for detailed documentation of the source code.

## Deployment

_BBBE_ binaries are publicly available as docker images. _BBBE_ is designed to run in distributed mode, and is composed of 3 modules: A [server](https://hub.docker.com/r/bluebrain/bioexplorer), a [python SDK](https://hub.docker.com/r/bluebrain/bioexplorer-python-sdk), and a [web user interface](https://hub.docker.com/r/bluebrain/bioexplorer-ui). This means that there are 3 docker images to be downloaded on run. Those images can of course run on different machines.

**Note:** The _BBBE_ is NOT a web application. It uses web technologies for the user interface but the _BBBE_ is a single session system that requires one back-end instance per user. There is no limitation in the number of user interface instances that can connect to the back-end, but they will all be sharing the same session.

In this example, we will expose the server on port 5000, the python SDK jupyter notebooks on port 5001, and the user interface on port 5002. One is free to change those ports at will.

### Server

```bash
docker run -ti --rm -p 5000:8200 bluebrain/bioexplorer
```

### Python SDK

```bash
docker run -ti --rm -p 5001:8888 bluebrain/bioexplorer-python-sdk
```

Note that a local folder can be specified to access personal notebooks:

```bash
docker run -ti --rm -p 5001:8888 -v <my_notebooks_folder>:/app/BioExplorer/notebooks bluebrain/bioexplorer-python-sdk
```

### Web User Interface

```bash
docker run -ti --rm -p 5002:8080 bluebrain/bioexplorer-ui
```

### PostgreSQL Database

A PostgreSQL Database can be created as a Docker image and used by the _BBBE_ as a storage component. More information on how to create and populate the database with sample datasets can be found in the dedicated [Docker Database documentation](./storage/database/DOCKER.md).

![___](https://raw.githubusercontent.com/BlueBrain/BioExplorer/master/bioexplorer/pythonsdk/doc/source/images/BBBE_screenshot.png)

## Building from Source

### BioExplorer

#### Compile

Run the following statements to build the _BBBE_.

```bash
git clone --recursive https://github.com/BlueBrain/BioExplorer.git
mkdir build
cd build
CMAKE_PREFIX_PATH=<brayns_installation_folder> cmake .. -DCMAKE_INSTALL_PREFIX=<brayns_installation_folder>
make install
```

#### Run

Run the _BBBE_  with the following command to start the backend:

```bash
service --http-server localhost:5000 --plugin BioExplorer
```

## Simple example

Considering that the _BBBE_ server is running on the local host, on port 5000, the simplest example to visualize a SARS-COV-2 coronavirus is:
```python
from bioexplorer import BioExplorer
be = BioExplorer('localhost:5000')
resource_folder = '../../tests/test_files/'
name='Coronavirus'
be.add_sars_cov_2(name=name, resource_folder=resource_folder)
```

# License

_BBBE_ is available to download and use under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0). The code is open sourced with approval from the open sourcing committee and principal coordinators of the Blue Brain Project in February 2022.

# Contact

For more information on _BBBE_, please contact:

* [__Cyrille Favreau__](https://www.epfl.ch/research/domains/bluebrain/blue-brain/people/our-people/operations-division/cyrille-favreau/) - Senior Scientific Visualization Engineer - Blue Brain Project ([cyrille.favreau@epfl.ch](cyrille.favreau@epfl.ch))

* [__Emmanuelle Logette__](https://www.epfl.ch/research/domains/bluebrain/blue-brain/people/our-people/simulation-neuroscience-division/emmanuelle-logette/) - Scientific collaborator - Blue Brain Project ([emmanuelle.logette@epfl.ch](emmanuelle.logette@epfl.ch))

* [__Evelyne Schmid Osborne__](https://www.epfl.ch/research/domains/bluebrain/blue-brain/people/our-people/operations-division/evelyne-schmid-osborne/) - Communications - Blue Brain Project ([evelyne.schmidosborne@epfl.ch](evelyne.schmidosborne@epfl.ch))

* Co-authors and contributors:
  * [Daniel Nachbaur](https://github.com/tribal-tec)
  * [Jonas Karlsson](https://github.com/karjonas)
  * [Andrei-Roland Groza](https://github.com/rolandjitsu)
  * [Grigori Chevtchenko](https://github.com/chevtche)
  * Raphael Dumusc
  * Ahmet Bilgili
  * Juan Bautista Hernando Vieites
  * [Pawel Jozef Podhajski](https://github.com/ppodhajski)
  * Jafet Villafranca Diaz

# Funding & Acknowledgment

The development of this software was supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government’s ETH Board of the Swiss Federal Institutes of Technology.

BioExplorer

BioExplorer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

BioExplorer

BioExplorer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README