跳转到主要内容

Altair和Vega-Lite可视化查看器。

项目描述

Altair Viewer

Altair可视化离线图表查看器

github actions github actions code style black

此软件包提供了在任意Python环境中查看Altair图表的工具。图表可以在Jupyter笔记本环境中内联显示,或者在一个单独的浏览器窗口中显示,以便在任何环境中使用。

Altair Viewer Gif

安装

Altair Viewer可以从Python包索引使用pip安装

$ pip install altair_viewer

用法:通用环境

Altair查看器提供两个顶级函数用于显示图表: display()show()。它们的使用目的略有不同

import altair_viewer
altair_viewer.display(chart)

display(chart) 适用于交互式计算环境,其中使用单个 Python 进程进行交互。它将在本地主机 URL 上提供图表查看器,并在会话中创建的任何后续图表都将显示在同一窗口中。后台服务器将在主 Python 进程终止时终止,因此不适用于独立脚本。

import altair_viewer
altair_viewer.show(chart)

show(chart) 用于 Python 脚本末尾的一次性使用。它与 display() 做相同的事情,但会自动打开浏览器窗口,并添加输入提示以防止脚本(及其创建的服务器)终止。

使用方法:IPython & Jupyter

在 Jupyter 笔记本、IPython 终端和相关支持 基于 MIME 类型显示 的环境中,可以通过启用 altair_viewer 渲染器使用 altair 查看器。

import altair as alt
alt.renderers.enable('altair_viewer')

这将导致 Jupyter 笔记本单元格末尾的图表在单独的浏览器窗口中渲染,类似于 display()show() 方法。

如果启用 inline=True,图表将在笔记本中内联渲染。

import altair as alt
alt.renderers.enable('altair_viewer', inline=True)

要在不全局启用相关渲染器的情况下,在 IPython 环境中使用 Altair 查看器显示单个内联图表,可以直接使用 display 方法。

import altair_viewer
altair_viewer.display(chart, inline=True)

请注意,基于 Altair 查看器的显示只有在创建图表的内核正在运行时才能正确工作,因为它依赖于内核启动的后台服务器。特别是,这意味着如果您保存了笔记本并在以后重新打开它,图表将不会显示,直到相关单元格重新运行。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。

源分布

altair_viewer-0.4.0.tar.gz (841.5 kB 查看哈希值)

上传

构建分布

altair_viewer-0.4.0-py3-none-any.whl (844.5 kB 查看哈希值)

上传 Python 3

由以下组织支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面