跳转到主要内容

适用于Jupyter笔记本的交互式绘图,使用d3.js和ipywidgets。

项目描述

bqplot

Travis Documentation Binder Chat

Project Jupyter 的二维绘图库

简介

bqplot 是一个基于 图形语法 构造的 Jupyter 二维可视化系统。

用法

Wealth of Nations

在 bqplot 中,每个绘图组件都是一个交互式小部件。这使用户能够通过几行 Python 代码将可视化与其他 Jupyter 交互式小部件集成,创建集成的 GUI。

目标

  • 提供一个统一的 2D 可视化框架,具有 Pythonic API
  • 提供一个合理的 API,用于添加用户交互(平移、缩放、选择等)

提供了两种 API

  • Object Model,受图形语法的构造(图形、标记、坐标轴、刻度)启发。此 API 语法冗长,但可完全自定义
  • pyplot,这是一个基于上下文的 API,类似于 Matplotlib 的 pyplot。 pyplot 为大多数参数提供了合理的默认值

在线尝试

要在线尝试 bqplot,只需点击 binder 链接

Binder

依赖项

此包依赖于以下包

  • ipywidgets(版本 >=7.0.0,<8.0)
  • traitlets(版本 >=4.3.0,<5.0)
  • traittypes(版本 >=0.2.1,<0.3)
  • numpy
  • pandas

安装

使用 pip

$ pip install bqplot

使用 conda

$ conda install -c conda-forge bqplot

如果您正在使用 JupyterLab <=2

$ jupyter labextension install @jupyter-widgets/jupyterlab-manager bqplot
开发安装

对于开发安装(需要 JupyterLab(版本 >= 3)和 yarn)

$ git clone https://github.com/bqplot/bqplot.git
$ cd bqplot
$ pip install -e .
$ jupyter nbextension install --py --overwrite --symlink --sys-prefix bqplot
$ jupyter nbextension enable --py --sys-prefix bqplot

开发人员注意事项:Linux 或 OS X 上的 --symlink 参数允许用户就地修改 JavaScript 代码。此功能在 Windows 上不可用。

对于实验性的 JupyterLab 扩展,安装 Python 包,确保已安装 Jupyter 小部件扩展,并安装 bqplot 扩展

$ pip install "ipywidgets>=7.6"
$ jupyter labextension develop . --overwrite

每次您对 JavaScript 代码进行更改时,都需要重新构建

cd js
yarn run build

然后刷新 JupyterLab/Jupyter Notebook 就足够重新加载更改。

运行测试

您可以使用以下命令安装运行测试所需的依赖项

    conda env update -f test-environment.yml

并用它来运行 Python 测试

    pytest

然后进入 cd js 来使用以下命令运行 JS 测试

yarn run test

每次您对测试进行更改时,都需要重新构建 JS 端

yarn run build

示例

使用 pyplot API

Pyplot Screenshot

使用 Object Model API

Bqplot Screenshot

文档

完整文档可在 https://bqplot.readthedocs.io/ 查看

安装以前的 bqplot 版本(仅适用于 JupyterLab <= 2)

为了安装以前的 bqplot 版本,您需要知道哪个前端版本(JavaScript)与后端版本(Python)匹配。

例如,为了安装 bqplot 0.11.9,您需要 labextension 版本 0.4.9

$ pip install bqplot==0.11.9
$ jupyter labextension install bqplot@0.4.9

版本查找表

后端(Python) 前端(JavaScript)
0.12.14 0.5.14
0.12.13 0.5.13
0.12.12 0.5.12
0.12.11 0.5.11
0.12.10 0.5.10
0.12.9 0.5.9
0.12.8 0.5.8
0.12.7 0.5.7
0.12.6 0.5.6
0.12.4 0.5.4
0.12.3 0.5.3
0.12.2 0.5.2
0.12.1 0.5.1
0.12.0 0.5.0
0.11.9 0.4.9
0.11.8 0.4.8
0.11.7 0.4.7
0.11.6 0.4.6
0.11.5 0.4.5
0.11.4 0.4.5
0.11.3 0.4.4
0.11.2 0.4.3
0.11.1 0.4.1
0.11.0 0.4.0

开发

请参阅我们的 贡献指南 了解如何贡献以及如何设置开发环境。

许可

此软件根据 Apache 2.0 许可证授权。有关详细信息,请参阅 LICENSE 文件。

项目详情


发布历史 发布通知 | RSS 源

下载文件

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

源分布

bqplot-0.12.43.tar.gz (1.2 MB 查看哈希值)

上传于 源代码

构建的发行版

bqplot-0.12.43-py2.py3-none-any.whl (1.2 MB 查看哈希值)

上传于 Python 2 Python 3

由以下支持

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