Constellation is a graph-focused data visualisation and interactive analysis application enabling data access, federation and manipulation capabilities across large and complex data sets.
Table of Contents
Vision Statement
Constellation is a first class, domain agnostic data visualisation and analysis application enabling the user to solve large and complex data problems in a simple and intuitive way.
-
Users: data analysts, data scientists, and all people interested in graph data analysis.
-
Data analysis domains: graph datasets with rich feature data e.g. social networks, network infrastructure, chemical composition, etc.
Core Values
Performance over Functionality
The most important value is making sure Constellation stays performant. If this means we have to sacrifice some functionality if it will degrade performance then that’s what we will do. Features are “easy” to add but keeping the application performant is harder.
Generic over Specialisation
Constellation is designed to provide a broad range of functionality with the idea of being a “bridge between tools”. For example Constellation’s Map View is not meant to be a fully fledged mapping tool; for that use ArcGIS.
Usability over Precision
We value sensible defaults in features so you can just use them rather than having to fill out a form of parameters first. This means that running analytics like the “Cosine Similarity Analytic” will be accurate but if you want to tweak this then you will have to use a different method like a Jupyter Notebook.
Prerequisites
- The OpenGL graph display works with NVIDIA and ATI graphics cards that support OpenGL 3.3 or later. It is known to not work with older Intel on-board graphics cards.
Download Constellation
Download Constellation by going to the release page.
Run Constellation
Unzip the constellation.zip bundle and double click the
constellation64.bat
for Windows or run the bin\constellation
shell
script for Linux and MacOSX.
Note that if you are running Constellation in a virtual machine and have issues using VirtualBox then give VMWare a go as it seems to have better support for OpenGL.
Build Constellation
To build Constellation from source code do the following:
-
Download Azul’s Zulu distribution of JDK 11 with JFX 11, either the Windows 64 bit, Linux 64 bit or MacOSX 64 bit
-
Download NetBeans 12
-
Update
netbeans_jdkhome
in netbeans.conf (e.g.C:\Program Files\NetBeans-12\netbeans\etc
) to point to the Azul Zulu JDK you downloaded (e.g.C:\Program Files\Azul\zulu11.37.19-ca-fx-jdk11.0.6-win_x64
) -
Clone this repository
-
Open the Constellation module suite from NetBeans
-
In the Projects view, expand
Important Files
>Build Script
> Right click >Update dependencies and clean build
. This can take around 20 minutes to download the first time depending on your internet connection so feel free to get a☕ and come back later. -
Start Constellation by right clicking on
Constellation
>Run
Package Constellation
To package Constellation in a zip bundle do the following:
-
In NetBeans, expand
Constellation
>Important Files
-
Right click on
Build Script
and run thebuild-zip
-
Navigate to the
dist
folder to getconstellation.zip
file -
If you want to use a specific JRE (e.g.
zulu11.37.19-ca-fx-jre11.0.6-win_x64
) then copy this to the same level as thebin
folder and call itjre
. This is the default folder name Constellation expects but you can change this frometc\constellation.conf
.
Note that Constellation “Core” (which is this repository) is designed to be domain agnostic and work standalone. The version of Constellation available for download from the official website is built with additional plugins and managed via the Constellation-Applications repository.
Contributing to Constellation
For more information please see the contributing guide.
Documentation
-
Constellation 101 Slides (coming soon)
-
Overview Video (coming later)
-
User Guide (coming later)
-
Built in documentation to Constellation exists
Training
-
Basics (Buttonology) (coming later)
-
Social Network Analysis (coming later)
Common Troubleshooting Checks
- You can check whether your graphics card is supported by following these steps:
-
Click on
File
>New Graph
to create a graph -
Click on
Experimental
>Build Graph
>Sphere Graph
to create a random graph. -
If you can see a graph try to interact with it using the mouse.
-
If the graph view remains blank, you may not have a supported graphics card.
-
Click on
Help
>JOGL Version
to see the graphics card capabilities of your machine. -
Click on
Help
>Show Logs
to view Constellation log information.
Acknowledgments
Third party libraries and assets were used in development of Constellation, please view attribution list for details.