This is an interactive 2D visualization tool for cluster analysis.
Features include:
- hover mouse over data point to see its features
- select a group of data points to be shown a summary of the features of the selected points (on the right) and a list of the selected rows (at the bottom)
- zoom in by selecting two boundary points
- specify the color feature
- the default color feature can be specified by appending "&color=column_name" to the URL
- specify gradient coloring by checkboxing "spectrum" (available for numeric features)
- specify shape feature
- specify search feature and search for a substring in the feature's values to highlight data points
- specify transparent feature and values, adjust opacity of matches and nonmatches
- when using semantic model, display lists of most frequently occurring words and top predicted words for data points selected via lasso or search
Plot tool expects a tsv file as input which has columns labeled 'x' and 'y' and at least one additional column. It also accepts tsv files renamed with .txt extension. Using txt files allows for faster loading via gzip.
Command line example to get the viz running:
- clone the repo
- run
npm install - inside the repo run: python3 -m http.server
- open your web browser to http://localhost:8000/index.html?dataset=example.tsv
To use semantic model:
- run representation_presenter.py and semantic_model.py (instructions in respective repos)
- open your web browser to http://localhost:8000/plot.html?dataset=example.tsv&semantic_model=true Note: semantic_model.py automatically generates .txt files for you, as files needed for semantic model get quite large. Thus, you can visit http://localhost:8000/plot.html?dataset=example.txt&semantic_model=true for a faster experience.
Valid URL query parameters are:
- Enabling checkboxes:
- 'log'
- 'spectrum'
- 'search_exact'
- 'transparency_exact'
- 'zoom'
- Preselecting DropDowns:
- 'color'
- 'search'
- 'transparency'
- 'click'
- 'shape'
This project uses webpack to bundle various modules together into a single bundle.js file that is embedded on the index.html page.
To start the webpack bundler service, run npm start (make sure you've npm installed). This command will watch the for changes in repo and update the bundle.js file to match saved changes.
NOTE: you must run bundler in order to have changes reflected in the overall file.
- TODO: migrate semantic model functionality from monolith version to modularized version of the tool
Check out the wiki to view a full regression test plan.