jupyterlab-vega2

JupyterLab的扩展，用于渲染Vega 2和Vega-lite 1。

Vega 2已弃用。最新版本默认包含在JupyterLab中。只有当您有无法与最新版本一起工作的规范时，才使用此扩展。

需求

• JupyterLab >= 3.0

安装

pip install jupyterlab-vega2

用法

在IPython中渲染Vega 2或Vega-lite 1输出

from IPython.display import display

display({
    "application/vnd.vegalite.v1+json": {
        "$schema": "https://vega.github.io/schema/vega-lite/v1.json",
        "description": "A simple bar chart with embedded data.",
        "data": {
            "values": [
                {"a": "A", "b": 28}, {"a": "B", "b": 55}, {"a": "C", "b": 43},
                {"a": "D", "b": 91}, {"a": "E", "b": 81}, {"a": "F", "b": 53},
                {"a": "G", "b": 19}, {"a": "H", "b": 87}, {"a": "I", "b": 52}
            ]
        },
        "mark": "bar",
        "encoding": {
            "x": {"field": "a", "type": "ordinal"},
            "y": {"field": "b", "type": "quantitative"}
        }
    }
}, raw=True)

要渲染.vg、.vl、.vg.json、.vl.json文件，只需打开它。

贡献

开发安装

注意：您需要NodeJS来构建扩展包。

jlpm命令是JupyterLab的固定版本yarn，它是与JupyterLab一起安装的。您可以使用下面的yarn或npm代替jlpm。

# Clone the repo to your local environment
# Change directory to the jupyterlab-vega2 directory
# Install package in development mode
pip install -e .
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Rebuild extension Typescript source after making changes
jlpm run build

您可以在不同的终端中同时监视源目录并运行JupyterLab，以监视扩展源的变化并自动重新构建扩展。

# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm run watch
# Run JupyterLab in another terminal
jupyter lab

在运行监视命令时，每次保存的更改都会立即在本地构建并可用于您正在运行的JupyterLab。刷新JupyterLab以在浏览器中加载更改（您可能需要等待几秒钟以重新构建扩展）。

默认情况下，jlpm run build命令为此扩展生成源映射，以便更容易使用浏览器开发者工具进行调试。要为JupyterLab核心扩展也生成源映射，您可以运行以下命令

jupyter lab build --minimize=False

卸载

pip uninstall jupyterlab-vega2