setvis 0.1rc3

Visualize set membership and missing data

setvis

Setvis is a python library for visualising set membership and patterns of missingness in data.

It can be used both programmatically and interactively in a Jupyter notebook (via Bokeh widgets). It operates on data using a memory efficient architecture, and supports loading data from flat files, Pandas dataframes, and directly from a Postgres database.

Documentation

The setvis documentation is hosted on Read the Docs.

Installation (quick start)

For the complete installation instructions, consult the installation page of the documentation, which includes information on some extra installation options and setting up a suitable environment on several platforms.

We recommend installing setvis in a python virtual environment or Conda environment.

To install setvis, most users should run:

pip install 'setvis[notebook]'

This will include everything to run setvis in a notebook, and to run the tutorial examples that do not need a database connection.

The Bokeh plots produced by setvis require the package notebook >= 6.4 to display properly. This will be included when installing setvis using the command above.

Tutorials

For basic examples, please see the two example notebooks:

• Missingness example
• Set example

Additionally, there is a series of Tutorials notebooks, starting with Tutorial 1.

After installing setvis, to follow theses tutorials interactively you will need to clone or download this repository. Then start jupyter from within it:

python -m jupyter notebook notebooks

Acknowledgements

The development of the setvis software was supported by funding from the Engineering and Physical Sciences Research Council (EP/N013980/1; EP/R511717/1) and the Alan Turing Institute.