https://github.com/glue-viz/glue-plotly
Experimental plot.ly plugin for glue
https://github.com/glue-viz/glue-plotly
data-science plotly plotly-python python visualization
Last synced: 7 months ago
JSON representation
Experimental plot.ly plugin for glue
- Host: GitHub
- URL: https://github.com/glue-viz/glue-plotly
- Owner: glue-viz
- License: bsd-3-clause
- Created: 2019-04-24T20:09:27.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-04-08T01:30:10.000Z (7 months ago)
- Last Synced: 2025-04-08T02:29:06.138Z (7 months ago)
- Topics: data-science, plotly, plotly-python, python, visualization
- Language: Python
- Homepage: http://glueviz.org/glue-plotly/
- Size: 11.5 MB
- Stars: 3
- Watchers: 6
- Forks: 8
- Open Issues: 7
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
|Actions Status| |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 toolbar demo|
In glue-jupyter, the Plotly exporter tools are top-level toolbar tools (look for the Plotly logo!)
|bqplot toolbar|
============
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.
|Chart Studio 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
.. |Actions Status| image:: https://github.com/glue-viz/glue-plotly/workflows/ci_workflows.yml/badge.svg
:target: https://github.com/glue-viz/glue-plotly/actions
:alt: Glue-plotly's GitHub Actions CI Status
.. |Coverage Status| image:: https://codecov.io/gh/glue-viz/glue-plotly/branch/master/graph/badge.svg
:target: https://codecov.io/gh/glue-viz/glue-plotly
:alt: Glue-plotly's Coverage Status
.. |Qt toolbar demo| image:: https://raw.githubusercontent.com/glue-viz/glue-plotly/main/docs/assets/img/QtToolbarExport.gif
:alt: Qt Plotly export demo
.. |bqplot toolbar| image:: https://raw.githubusercontent.com/glue-viz/glue-plotly/main/docs/assets/img/BqplotToolbarHighlighted.png
:alt: bqplot Plotly export tool
.. |Chart Studio demo| image:: https://raw.githubusercontent.com/glue-viz/glue-plotly/main/docs/assets/img/QtChartStudioExport.gif
:alt: Qt Chart Studio export demo