UpSet 2 is deployed at https://upset.multinet.app/.
UpSet is an interactive, web based visualization technique designed to analyze set-based data. UpSet visualizes both, set intersections and their properties, and the items (elements) in the dataset.
Please see the http://upset.app for more info about UpSet.
This version is a re-implementation using modern web technologies of the original UpSet.
UpSet 2 is described in this short poster:
Kiran Gadhave, Hendrik Strobelt, Nils Gehlenborg, Alexander Lex
UpSet 2: From Prototype to Tool
Proceedings of the IEEE Information Visualization Conference – Posters (InfoVis ’19), 2019.
UpSet 2 is based on the original UpSet, which was first described in this paper:
Alexander Lex, Nils Gehlenborg, Hendrik Strobelt, Romain Vuillemot, Hanspeter Pfister
UpSet: Visualization of Intersecting Sets
IEEE Transactions on Visualization and Computer Graphics (InfoVis), 20(12): 1983--1992, doi:10.1109/TVCG.2014.2346248, 2014.
Developer documentation can be found at https://vdl.sci.utah.edu/upset2/.
For more information on documentation see the Developer Documentation Guidelines.
To deploy UpSet 2.0 locally it is necessary to install the Multinet infrastructure.
- Clone Multinet API, Multinet Client, and Multinet JS into individual folders.
- Follow the installation instructions for Multinet API and Multinet Client.
- Clone the repository using
git clone
or download and extract the zip file. - Open terminal in the cloned folder and run
yarn install
- Run
yarn build
in the terminal to compile. - Navigate to the upset2 folder.
- In
packages/app
copy.env.default
and rename the copied file to.env
- In the OAUTH application created during the OAUTH API setup of Multinet API, add
http://localhost:3000/
to the redirect uris field. - Copy the
Client id
field in the application but do not modify the value - Navigate to the
.env
file created in step 5. - Paste the
Client id
to the fieldVITE_OAUTH_CLIENT_ID
To run UpSet 2.0 locally, first, complete the Local Installation steps. Then, use yarn dev
to run UpSet 2.0 on port 3000.
A browser window for localhost:3000
will open during the launch process.
To run the playwright end to end tests, use the command:
yarn test
To open the test in a UI view to track steps, append --ui
.
This will launch a local server if there is not one already running on port 3000.
To add a test, add a .spec.ts
file to e2e-tests
. For information on how to use playwright, please see the playwright documentation.
When adding a new feature, ensure that your additions are well documented following JSDoc style annotations.
To build the documentation locally, use the command: yarn doc
. The default file output is at /docs
.