Altair Saver

此软件包提供了对Altair的扩展，用于将图表保存到多种输出类型。支持的输出格式包括

• .json/.vl.json：Vega-Lite JSON规范
• .vg.json：Vega JSON规范
• .html：HTML输出
• .png：PNG图像
• .svg：SVG图像
• .pdf：PDF图像

使用方法

altair_saver库有一个公共函数，即altair_saver.save()。给定一个名为chart的Altair图表，可以使用它如下所示

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

渲染器

此外，altair_saver提供了一个Altair 渲染器入口，可以直接在Jupyter笔记本中显示上述输出。例如，您可以指定一个vega-lite MIME类型（由JupyterLab、nteract和其他平台支持），并为其他前端提供一个PNG回退，如下所示

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

安装

可以使用以下命令安装altair_saver包：

$ pip install altair_saver

将文件保存为vl.json和html无需额外设置。

要使用conda安装，请使用以下命令

$ conda install -c conda-forge altair_saver

conda包安装了以下描述的NodeJS依赖项，因此可以在不进行额外设置的情况下将图表保存为png、svg和pdf。

其他要求

将输出保存为png、svg和pdf需要执行JavaScript代码，而altair_saver可以通过两种后端之一来完成。

Selenium

Selenium后端支持以下格式：

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

要使用，它需要Selenium Python包，以及chromedriver或geckodriver的正确配置安装。

在Linux系统上，可以设置如下：

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

使用conda，可以按照以下方式安装所需的包（必须单独安装兼容版本的Google Chrome）：

$ conda install -c python-chromedriver-binary

Selenium还支持其他浏览器，但altair-saver目前仅在Chrome上进行了测试。

NodeJS

nodejs后端支持以下格式：

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

它需要NodeJS，以及vega-lite、vega-cli和canvas包。

首先通过直接下载或通过包管理器安装NodeJS，然后使用npm工具安装所需的包

$ npm install vega-lite vega-cli canvas

使用conda，可以按照以下方式安装node和所需的包

$ conda install -c conda-forge vega-cli vega-lite-cli

这些包在通过conda-forge安装altair_saver时自动包含在内。