altair-saver 0.1.0

A python engine for evaluating Altair transforms.

Altair Saver

This packge provides extensions to Altair for saving charts to a variety of output types. Supported output formats are:

• .json/.vl.json: Vega-Lite JSON specification
• .vg.json: Vega JSON specification
• .html: HTML output
• .png: PNG image
• .svg: SVG image
• .pdf: PDF image

Usage

The altair_saver library has a single public function, altair_saver.save(). Given an Altair chart named chart, you can use it as follows:

from altair_saver import save

save(chart, "chart.vl.json")              # Vega-Lite JSON specification
save(chart, "chart.vg.json")              # Vega JSON specification
save(chart, "chart.html")                 # HTML document
save(chart, "chart.html", inline=True)    # HTML document with all JS code included inline
save(chart, "chart.png")                  # PNG Image
save(chart, "chart.svg")                  # SVG Image
save(chart, "chart.pdf")                  # PDF Image

Renderer

Additionally, altair_saver provides an Altair Renderer entrypoint that can display the above outputs directly in Jupyter notebooks. For example, you can specify a vega-lite mimetype (supported by JupyterLab, nteract, and other platforms) with a PNG fallback for other frontends as follows:

alt.renderers.enable('altair_saver', ['vega-lite', 'png'])

Installation

The altair_saver package can be installed with:

$ pip install git+https://github.com/altair-viz/altair_saver.git

Saving as vl.json and as html requires no additional setup.

To save charts in other formats requires additional dependencies in order to execute the javascript code used to render and save Altair charts. altair_saver provides interfaces to two different backends, respectively based on Selenium and NodeJS.

Selenium

The selenium backend supports the following formats:

• .vg.json
• .png
• .svg.

To be used, it requires the Selenium Python package, and a properly configured installation of either chromedriver or geckodriver.

On Linux systems, this can be setup as follows:

$ pip install selenium
$ apt-get install chromium-chromedriver

Using conda, the required packages can be installed as follows (a compatible version of Google Chrome must be installed separately):

$ conda install -c python-chromedriver-binary

Selenium supports other browsers as well, but altair-saver is currently only tested with Chrome.

NodeJS

The nodejs backend supports the following formats:

• .vg.json
• .png
• .svg
• .pdf

It requires NodeJS, along with the vega-lite, vega-cli, and canvas packages.

First install NodeJS either by direct download or via a package manager, and then use the npm tool to install the required packages:

$ npm install vega-lite vega-cli canvas

Using conda, node and the required packages can be installed as follows:

$ conda install -c conda-forge nodejs
$ npm install -g vega-lite vega-cli canvas