Skip to content

A Flexible and Extensible Visual Analytics Framework for High-Dimensional Data

License

Notifications You must be signed in to change notification settings

ManiVaultStudio/core

Repository files navigation

AppIcon32 ManiVault Core

License: LGPL v3.0 Build Status GitHub contributors Webpage

ManiVault is a flexible and extensible visual analytics framework for high-dimensional data.

The system allows for creating custom visualization applications tailored to your specific field, data, and preferences. Applications are composed of several modular plugins, that can be combined to fit your needs. The plugins are fully self-encapsulated but can communicate through ManiVault's core. For more information on the system, see our wiki.

The best starting point is the example plugins which showcases each possible plugin type.

The three projects above have all been built using ManiVault (Vieth et al. 2022: plugin, Popa et al. 2022: plugin, Li et al. 2023: plugin).

Installation & Building

The install guide gives a complete overview of ManiVault's dependencies and setup.

Before building ManiVault, be sure to set up Qt6, then clone this repo:

git clone git@github.com:ManiVaultStudio/core.git
Automated using DevBundle (available for BioVault team members)

The preferred approach to building the example plugins is by using our DevBundle tool. This cross-platform tool creates self-contained development environments using build configurations in JSON format. Since the build environments are self-contained, multiple build environments can exist side-by-side. The major advantage of using DevBundle is that it will remove much of the configuration overhead by:

  • Cloning repositories from the build configuration (with the branch specified in the build configuration)
  • Downloading related binary dependencies from our Artifactory server (and adding/configuring paths in the CMakeLists.txt)
  • Setting up an umbrella CMakeLists.txt which consists of all projects from the build configuration

Note: the allmain build config in the DevBundle config.json contains an example of how to add the core and plugins to a build configuration.

References

ManiVault was first presented at IEEE VIS 2023 in the paper ManiVault: A Flexible and Extensible Visual Analytics Framework for High-Dimensional Data (2023). A preprint is available on arXiv, other supplemental material are available here or on OSF.

@article{vkt2023manivault,
	title        = {ManiVault: A Flexible and Extensible Visual Analytics Framework for High-Dimensional Data},
	author       = {Vieth, Alexander and Kroes, Thomas and Thijssen, Julian and van Lew, Baldur and Eggermont, Jeroen and Basu, Soumyadeep and Eisemann, Elmar and Vilanova, Anna and Höllt, Thomas and Lelieveldt, Boudewijn},
	year         = 2024,
	journal      = {IEEE Transactions on Visualization and Computer Graphics},
	volume       = 30,
	number       = 1,
	pages        = {175--185},
	doi          = {10.1109/TVCG.2023.3326582}
}

License

ManiVault is licensed under LGPL v3.0, refer to the LICENSE file in the top level directory.

Copyright © 2024 BioVault (Biomedical Visual Analytics Unit LUMC - TU Delft)