Skip to content

A lightweight, interactive, extensible and cross-platform framework for building, visualizing and analyzing vasculature (or blood vessels) morphologies.

License

Notifications You must be signed in to change notification settings

BlueBrain/VessMorphoVis

Repository files navigation

DOI

Introduction

VessMorphoVis is an integrated suite of toolboxes for interactive visualization and analysis of vast brain vascular networks represented by morphological graphs segmented originally from imaging or microscopy stacks. Our workflow leverages the outstanding potentials of Blender, aiming to establish an integrated, extensible and domain-specific framework capable of interactive visualization, analysis, repair, high-fidelity meshing and high-quality rendering of vascular morphologies. VessMorphoVis is developed as an extension to its sister NeuroMorphoVis.

Features

  • Interactive visualization, analysis and automated repair of large-scale vasculature morphology skeletons (up to millions of samples).

  • Sketching and building three-dimensional representations of the vascular morphology skeletons using various methods for visual analytics.

  • Analysis of neuronal morphology skeletons that are digitally reconstructed from imaging or microscopy stacks.

  • An easy context to load broken morphology skeletons and repair them manually.

  • Automated reconstruction of polygonal mesh models that represent the surface of the vasvular morphologies based on the piecewise meshing method presented by Abdellah et al., 2017.

  • Accurate mesh reconstruction with MetaBalls to create watertight meshes for reaction-diffusion simulations.

  • Large scale and efficient rendering of the vascular morphologies and meshes using the Workbench renderer.

  • Automated high quality rendering of the vascular morphologies and their corresponding meshes using different shading nodes with Cycles.

  • Exporting the reconstructed meshes in several file formats including PLY, OBJ, STL and also as a Blender file (.blend).

Package Details

VessMorphoVis is mainly based on Blender. Blender is a free software and can be downloaded from Blender.org. Blender is released under the GNU General Public License (GPL, or “free software”). The current version of VessMorphoVis is compatible with the following Blender versions:

VessMorphoVis can be downloaded as a binary archive bundled within Blender that can be easily extracted and used out-of-the-box. The optional dependencies are already shiped within this archive using pip on each respective platform. This package (released every minor version update of the software) is recommended for Windows users or those who cannot use the Terminal. Otherwise, users can just download an installation script that will automatically install the entire package to a user-specified directory. This script does not require sudo permissions.

Documentation

The documentation is available here.

Known Bugs or Feature Requests

Please refer to the github issue tracker for fixed and open bugs. User can also report any bugs and request new features needed for their research. We are happy to provide direct support .

Gallery

Publications & Citation

If you use VessMorphoVis for your research, media design or other purposes, please cite our paper Interactive visualization and analysis of morphological skeletons of brain vasculature networks with VessMorphoVis using the following entry:

@article{abdellah2020interactive,
  title={Interactive visualization and analysis of morphological skeletons of brain vasculature 
         networks with VessMorphoVis},
  author={Abdellah, Marwan and Guerrero, Nadir Román abd Lapere, Samule and Coggan, Jay S. and 
          Coste, Benoit and Dagar, Snigdha and Keller, Daniel and Courcol, Jean-Denis and 
          Markram, Henry and Sch{\"u}rmann, Felix},
  journal={Bioinformatics},
  volume={In press},
  year={2020},
  publisher={Oxford University Press}
}

Acknowledgement & Funding

VessMorphoVis is developed by the Visualization team at the Blue Brain Project, Ecole Polytechnique Federale de Lausanne (EPFL). This study 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.

License

VessMorphoVis is available to download and use under the GNU General Public License (GPL, or “free software”). The code is open sourced with approval from the open sourcing committee and principal coordinators of the Blue Brain Project in June 2020.

Copyright (c) 2019-2022 Blue Brain Project/EPFL

Attributions

Contact

For more information on VessMorphoVis, comments or suggestions, please contact:

Marwan Abdellah
Scientific Visualiation Expert
Visualization Team, Computing Division
Blue Brain Project
marwan.abdellah@epfl.ch
marwan-abdellah.com