README.md

Interactive Atlas Viewer

Interactive Atlas Viewer is an frontend module wrapping around nehuba. It provides additional features, such as metadata integration, data visualisation and a robust plugin system.

Getting Started

A live version of the Interactive Atlas Viewer is available at https://kg.humanbrainproject.org/viewer/. This section is useful for developers who would like to develop this project.

General information

Interactive atlas viewer is built with Angular (v6.0), Bootstrap (v4), and fontawesome icons. Some other notable packages used are: ng2-charts for charts visualisation, ngx-bootstrap for UI and ngrx/store for state management.

Prerequisites

• node > 6
• npm > 4

Develop Interactive Viewer

To run a dev server, run:

git clone https://github.com/HumanBrainProject/interactive-viewer
cd interactive-viewer
npm i
npm run dev-server

Develop Plugins

To develop plugins for the interactive viewer, run:

git clone https://github.com/HumanBrainProject/interactive-viewer
cd interactive-viewer
npm i
npm run dev-plugin

/* or define your own endpoint that returns string of manifests */
PLUGINDEV=http://mycustom.io/allPluginmanifest npm run dev-server

The contents inside the folder in ./src/plugin_examples will be automatically fetched by the dev instance of the interactive-viewer on load.

plugin readme

plugin api

plugin migration guide

Deployment

package.json provide with two ways of building the interactive atlas viewer, JIT or AOT compilation. In general, AOT compilation produces a smaller package and has better performance.