Skip to content

glue-viz/glue-plotly

Glue-plotly's GitHub Actions CI Status Glue-plotly's Coverage Status

Experimental plot.ly plugin for glue

This package is a plugin for glue that allows linking glue to Plotly. This includes three main pieces of functionality:

  • Export glue views to standalone HTML pages
  • Export glue views to Plotly's Chart Studio
  • Experimental glue viewers powered by Plotly

Installation

glue-plotly can be installed using pip:

pip install glue-plotly

Additionally, glue-plotly is included in the glue standalone applications for MacOS and Windows.

HTML Exporters

The HTML exporters are exposed as viewer tools in both glue-qt and glue-jupyter

For glue-qt, all of the built-in matplotlib viewers are supported, along with the dendrogram viewer and the 3D scatter viewer from the glue-vispy-viewers plugin. For glue-jupyter, the bqplot scatter, image, profile, and histogram viewers are supported. In glue-qt, these tools are subtools of the "save" meta-tool and can be accessed from its dropdown menu.

Qt Plotly export demo

In glue-jupyter, the Plotly exporter tools are top-level toolbar tools (look for the Plotly logo!)

bqplot Plotly export tool

Chart Studio

The Chart Studio exporter allows exporting a Qt glue session to Chart Studio, provided that all of the viewers in the session are supported. Currently supported viewers are the matplotlib scatter, histogram, profile, and dendrogram viewers.

To access the exporter inside Qt glue, navigate to File > Advanced Exporters > Plotly.

Qt Chart Studio export demo

Viewers

This package contains two experimental Plotly-powered viewers which can be used with glue-jupyter - a scatter viewer and a histogram viewer. More viewers to come in the future!

This notebook demonstrates basic usage of the these viewers, such as importing and viewer creation.

Package Structure

  • common contains methods for creating Plotly graph objects traces to represent glue layers and viewers that are shared between the exporters and Plotly viewers.
  • html_exporters contains the implementations of the HTML exporter tools for glue-qt and glue-jupyter
  • web contains the implementation of the Chart Studio exporter for Qt glue
  • viewers contains the implementations of the Plotly viewers