Working with Dataframe Index in Lux

In [ ]:
import pandas as pd
import lux
In [ ]:
# Collecting basic usage statistics for Lux (For more information, see:
lux.logger = True # Remove this line if you do not want your interactions recorded

An index is a convenient way for users to access and manipulate the values of a dataframe. Often, indices are created as part of dataframe operations, such as groupby, pivot, or crosstab.

Lux allows users to visualize dataframe with indices. In pandas, there are two types of indices:

  1. column index (accessed via .columns property of the dataframe), and
  2. row index (accessed via .index property of the dataframe).

A dataframe index can be thought of as an extra row/column that indicates the values that the user is interested in. Lux focuses on visualizing named dataframe indices, i.e., indices with a non-null name property, as a proxy of the attribute that the user is interested in or have operated on (e.g., group-by attribute). In particular, dataframes with named indices are often pre-aggregated, so Lux visualizes exactly the values that the dataframe portrays.

For every named row/column indexes in Pandas, Lux displays the corresponding types of actions:

  1. Column Groups: shows all possible visualizations generated by groups of column-wise values

  2. Row Groups: shows all possible visualizations generated by groups of row-wise values

We will illustrate these two different actions in this tutorial.

Column Group Example: Group-by aggregation

In this example, we group by FundingModel and compute the average value of the numeric attribute.

In [ ]:
df = pd.read_csv("../data/college.csv")

The Column Groups action in Lux shows all possible bar chart distributions based on these pre-computed average values.

In [ ]:

Here, since the column index is unnamed, with the columns simply being a subset of the attributes in the original dataframe, Lux does not show the visualization based on each row (Row Group action).

Row Group Example: Time Series

There are various common ways to represent time series data via a dataframe. One of the most common ways is a "long" table representation where each observation is stored independently, one for each row, as shown in the example below:

In [ ]:
url = ''
df = pd.read_csv(url)
df["Date"] = pd.to_datetime(df["Date"])

To re-arrange this dataframe into time series where each State represents a line chart, we perform the pivot operation, alongside some interpolation to fill in the missing values. This gives us a "wide" table representation where the column index is each Date, and the row index is each State.

In [ ]:
tseries = df.pivot(index="State",columns="Date",values="Value")
# Interpolating missing values
tseries[tseries.columns.min()] = tseries[tseries.columns.min()].fillna(0)
tseries[tseries.columns.max()] = tseries[tseries.columns.max()].fillna(tseries.max(axis=1))
tseries = tseries.interpolate('zero',axis=1)

Since both the row and column index is named, Lux displays both Row and Column Group actions.

In [ ]:
print ("Column Index Name:",
print ("Row Index Name:",

Lux displays the Row Groups action where each row is plotted as a time series. This allows us to take a look at the time series, from Alabama to Wyoming. Note that in both the Row and Column Groups, we do not perform sorting of the visualizations in order to preserve their one-to-one correspondence with what is displayed in the dataframe.

In [ ]:

Column Group action is less interesting in this case, nevertheless, we can still see that starting from Febrary, Oregon had the leading values compared to other states. As we move towards March and April, California and Florida becomes one of the states with the highest values.

Complementary Perspectives of Row and Column Groups: Cross-Tabulation of Two Factors

Often, Row and Column Groups can present complementary perspectives on the dataset. This is especially true for dataframes resulting from pandas.cross-tab.

In [ ]:
# Example from
d = {
    'Exam':['Semester 1','Semester 1','Semester 1','Semester 1','Semester 1','Semester 1',
            'Semester 2','Semester 2','Semester 2','Semester 2','Semester 2','Semester 2'],
df = pd.DataFrame(d,columns=['Name','Exam','Subject','Result'])

The cross-tabulation sums up the number of occurrences for a particular outcome. For example, two students failed the exam in Semester 1, and four passed.

The Row Group shows visualizations comparing the Result of Fail/Pass across Semesters. The first visualization indicates that more students passed than failed in Semester 1, whereas in Semester 2, the Fail/Pass rate is equal amongst the students. The Column Group shows visualizations comparing the exam results from different Semesters across different results.

In [ ]:
result = pd.crosstab([df.Exam],df.Result)
In [ ]:
result = pd.crosstab([df.Subject],df.Result)

Note that Lux does not currently support dataframes with multiple index levels, as a result, it does not support crosstabs with more than 2 factors.

In [ ]:
result = pd.crosstab([df.Subject,df.Exam],df.Result)