Skip to content
Automatic insights discovery and visualization for data analysis.
TypeScript JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore chore: add code coverage test Jan 17, 2020
.travis.yml chore: fix ci Jan 19, 2020
LICENSE feat: full test for lib Aug 29, 2019
package.json chore: fix ci Jan 19, 2020

English | 简体中文



Automatic insights extraction and visualization specification based on visual-insights.


Rath helps you extract insights from datasource automatically and generate interactive visualization with interesting findings.

In this repo,

  • visual-insights is the core lib containing insight finding algorithm, auto specification, dashboard generator, etc.
  • frontend is a demo build based on visual-insights. frontend can be run individually without server. All the computation service are running in webworker by default.
  • When you want to switch to server mode, you can run backend code.

Here are main parts in Rath,


dataSource board is for data uploading, sampling(currently support stream data, which means there is no limit of the size of file you uploaded), cleaning and defining fields type(dimensions, measures). In visual insights, we regard dimensions as independent variable or feature and measures as dependent variable or target.


Notebook is a board for user to know what happened in the automatic analysis process and how rath uses visual-insights. It shows how decisions are made by the application and provide interactive interface to adjust some of the parameters and operators used by the algorithm.


Gallery displays parts of the visualization with interesting findings. In Gallery, you can find interesting visualizaiton and use association feature to find more related visualization. You can also search specific info in gallery. There are some settings here to adjust some of the visual elements in the chart.


automantic generate dashboard for you. rath will figure out a set of visulization of which contents are connected to each other and can be used to analysis a specific problem.


Details of the test result can be accessed here


Try online demo

  • on Github Pages demo
  • on Alibaba Cloud OSS demo

Download Desktop Version

run locally


# under project root dir
yarn workspace visual-insights build

yarn workspace frontend start

yarn workspace backend dev

# localhost:3000

production mode

yarn workspace visual-insights build

yarn workspace frontend build

yarn workspace backend dev

# server:8000

only use the algorithm package. (/packages/visual-insights)

npm i visual-insights --save`

How does it work

The working process are visualized in notebook board in the application. *** Main process of the algorithm is shown in the notebook board. *** Here shows how rath use visual-insights to make a analytic pipeline.

Univariate summary

For the first step, rath analyze all the fields in the dataset independently. It gets the fields' distributions and calculate its entropy. Besides, it will define a semantic type (quantitative, ordinal, temporal, nominal) for each field. More details of the field will be displayed when hover your mouse on the fields.

Then, it will find the fields with high entropy and try to reduce it by grouping the field (for example). Only dimensions participates this process.


In this step, visual insights search the combination of fields, and calculate the entropy of each measure with some aggregation operators.


After one subspace is specified (try to click one row of subsapce in notebook), it will analyze the correlation of measures in the space.


It helps you to cluster all the measures based on their correlation. It puts all the variables who are strongly related together to make a specific view (with specified dimenions).

Click one group of measures and visualization will be shown at the bottom of the page.

Specification & Visualization





Rath is insipired by several excellent works below:

  • Wongsuphasawat, Kanit, et al. "Voyager 2: Augmenting visual analysis with partial view specifications." Proceedings of the 2017 CHI Conference on Human Factors in Computing Systems. ACM, 2017.
  • B. Tang et al, "Extracting top-K insights from multi-dimensional data," in 2017, . DOI: 10.1145/3035918.3035922.
  • A. Satyanarayan, K. Wongsuphasawat and J. Heer, "Declarative interaction design for data visualization," in 2014, . DOI: 10.1145/2642918.2647360.
  • Cleveland, W., & McGill, R. (1984). Graphical Perception: Theory, Experimentation, and Application to the Development of Graphical Methods. Journal of the American Statistical Association, 79(387), 531-554. doi:10.2307/2288400
You can’t perform that action at this time.