适用于Jupyter笔记本的交互式绘图,使用d3.js和ipywidgets。
项目描述
bqplot
Project Jupyter 的二维绘图库
简介
bqplot
是一个基于 图形语法 构造的 Jupyter 二维可视化系统。
用法
在 bqplot 中,每个绘图组件都是一个交互式小部件。这使用户能够通过几行 Python 代码将可视化与其他 Jupyter 交互式小部件集成,创建集成的 GUI。
目标
- 提供一个统一的 2D 可视化框架,具有 Pythonic API
- 提供一个合理的 API,用于添加用户交互(平移、缩放、选择等)
提供了两种 API
Object Model
,受图形语法的构造(图形、标记、坐标轴、刻度)启发。此 API 语法冗长,但可完全自定义pyplot
,这是一个基于上下文的 API,类似于 Matplotlib 的 pyplot。pyplot
为大多数参数提供了合理的默认值
在线尝试
要在线尝试 bqplot,只需点击 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
使用 Object Model
API
文档
完整文档可在 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 文件。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源分布
构建的发行版
bqplot-0.12.43.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | f2b469d1f03df4f51873cb0406a24b56cdf4a835fc5aa9560776fc636b8b3449 |
|
MD5 | 484c5048b064b409d72b29a1fe1add54 |
|
BLAKE2b-256 | 3e47b8613e25549ccfb9cc5836086772e19db0246c10978d8eb13c7980820a74 |
bqplot-0.12.43-py2.py3-none-any.whl的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 65aa2f10bf2e4b500e628d5c1b876e6d2cdc2b82883200e4b1bb65edc17d111b |
|
MD5 | 6a2f23399567b9013295160184b6aff4 |
|
BLAKE2b-256 | adf5717a355a47e8ba28ff9fcbe63d3014b55a8d20f3983582205085e85e2869 |