ProvenanceWidgets Homepage

The homepage for ProvenanceWidgets - A JavaScript library of UI Controls for Tracking and Dynamically Overlaying Analytic Provenance. This repository includes demos that showcase the capabilities of ProvenanceWidgets and examples of how the library can be used in various scenarios.

Authors: Arpit Narechania, Kaustubh Odak, Mennatallah El-Assady, and Alex Endert

Operating Systems: Windows 10 or newer, MacOSX 11 or newer, Ubuntu 20.04.1 LTS or newer

Setup

• Open the command line/terminal on your machine and navigate to this project's top-level directory (i.e. where this file is).
• Download and install node, npm from https://nodejs.org/en/download/. Optionally, use the nvm (Node Version Manager) to quickly install and use different versions of node via the command line. Note the compatible node/npm version in package.json > "engines".
• Install compatible Angular npm install -g @angular/cli@15.2.9
• npm install - installs required libraries from package.json.

Run

• npm run start
• Open the browser (preferrably Chrome) at http://localhost:4200.

The visualizations from the paper can be accessed by visiting the following URLS:

1. Scented widgets: http://localhost:4200/#/scented-widgets
2. Phosphor objects: http://localhost:4200/#/phosphor-objects
3. Dynamic Query Widgets: http://localhost:4200/#/dynamic-query-widgets-homefinder
4. Widgets to visualization one-way interaction: http://localhost:4200/#/widgets-to-vis-one-way
5. Visualization to widgets one-way interaction: http://localhost:4200/#/vis-to-widgets-one-way

Test

• npm run test

Build

• npm run build outputs the build in the ./dist/ folder.

Deployment

• Github Actions is setup via the .github/workflows/build.yaml file. Built files are pushed to gh-pages branch and served via Github Pages at https://provenancewidgets.github.io.