lineup-widget 4.0.0

Wrapper around the LineUp.js library for multi attribute rankings

LineUp.js as Jupyter Widget

LineUp is an interactive technique designed to create, visualize and explore rankings of items based on a set of heterogeneous attributes. This is a Jupyter Widget wrapper around the JavaScript library LineUp.js. Details about the LineUp visualization technique can be found at http://lineup.caleydo.org.

Installation

1. install Jupyter Widgets

   pip install ipywidgets
   jupyter nbextension enable --py widgetsnbextension
   

2. install library

   pip install lineup_widget
   jupyter nbextension enable --py --sys-prefix lineup_widget
   

3. OR directly via repository (requires node and npm to be installed):

   pip install -e git+https://github.com/lineupjs/lineup_widget.git#egg=lineup_widget
   jupyter nbextension enable --py --sys-prefix lineup_widget
   

4. Jupyterlab

   jupyter labextension install @jupyter-widgets/jupyterlab-manager
   jupyter labextension install lineup_widget
   jupyter lab
   

Examples

import lineup_widget
import pandas as pd
import numpy as np

df = pd.DataFrame(np.random.randint(0,100,size=(100, 4)), columns=list('ABCD'))

w = lineup_widget.LineUpWidget(df)
w.on_selection_changed(lambda selection: print(selection))
w

from __future__ import print_function
from ipywidgets import interact, interactive, interact_manual

def selection_changed(selection):
    return df.iloc[selection]

interact(selection_changed, selection=lineup_widget.LineUpWidget(df));

Hint:

In case you see scrollbars in each cell it is because of the font the cells are too narrow, you can specify a larger row height using

w = lineup_widget.LineUpWidget(df, options=dict(rowHeight=20))

Release Package

1. JavaScript NPM

   cd js
   npm install
   npm publish
   

2. Python PyPi

   pip install -U twine setuptools
   
   python setup.py clean sdist bdist_wheel
   twine upload dist/*
   

3. Git

   git tag v<version>
   git push --follow-tags
   

4. update versions edit the version in

   • js/package.json
   • js/lib/version.ts
   • lineup_widget/_version.py

Authors

• Samuel Gratzl (@sgratzl)