mpld3：Matplotlib的D3查看器

• 维护者：@vladh，@cliffckerr
• 状态：我现在无法投入太多时间来解决mpld3的问题。但是，我会很高兴地查看你的pull request并对其进行审查。请尝试解决你遇到的问题，并发送一个PR，而不仅仅是提交一个问题——大多数问题不需要你想象中那么长时间就能解决！
• 原作者：Jake Vanderplas jakevdp@cs.washington.edu
• 许可证：BSD 3条款

这是一个基于D3js的交互式查看器，可以将matplotlib图形带到浏览器中。请访问http://mpld3.github.io以获取文档和示例。

您还可以查看博客文章，或者查看此存储库的notebooks目录中可用的IPython笔记本示例。

关于

mpld3提供了一个基于D3的自定义独立javascript库，它解析图表的JSON表示。mpld3 python模块提供了一套解析matplotlib图表（使用mplexporter框架）并输出mpld3.js可读取的JSON描述的例程。

安装

mpld3与python 2.6-2.7和3.3-3.4兼容。它需要matplotlib版本2.2.2和jinja2版本2.7+。

可选地，mpld3可以与IPython笔记本一起使用，并需要IPython版本1.x或（更理想的是）版本2.0+。

此软件包基于mplexporter框架，用于爬取和导出matplotlib图像。mplexporter通过git子模块包含在源分布中。

在git源目录中，您可以使用以下命令下载mplexporter依赖项并将其复制到mpld3源目录中

$ python setup.py submodule

如果您是从分布安装而不是从git源安装，则不需要子模块命令。

运行子模块命令后，您可以使用以下命令本地构建软件包

$ python -m build

或使用以下命令将软件包安装到标准的Python路径中

$ pip install .

或，要将软件包安装到其他位置，请使用

$ pip install . --prefix=/path/to/location/

然后确保您的PYTHONPATH环境变量指向此位置。

尝试使用

此软件包是纯Python的，非常轻量级。您可以查看示例目录中的notebooks，或运行create_example.py，这将创建一系列图表并在浏览器窗口中显示这些图表的交互式视图。

有关更全面的示例，请参阅notebooks目录中可用的IPython笔记本示例。

测试图表

要探索各种图表类型的D3渲染和matplotlib渲染之间的比较，请运行脚本visualize_tests.py。这将生成一个HTML页面，其中包含D3渲染和相应的matplotlib渲染。

功能

matplotlib的核心功能中的许多已经得到支持。此外，通过插件框架提供了一些额外的交互性。以下是一个尚未支持的功能的非详尽列表

• 刻度指定和格式化
• 一些图例功能
• 混合变换，例如 axvlines 和 axhlines 所需的
• 双轴（即一个图上的多个刻度）相互关联

如果您想尝试这些中的任何一项，请随时提交一个拉取请求！