pycbc-mpld3 0.3.dev0

关于

mpld3提供了一个基于D3构建的自定义独立JavaScript库，该库解析图表的JSON表示。mpld3 Python模块提供了一组解析matplotlib图表（使用[mplexporter](http://github.com/mpld3/mplexporter）框架）并输出mpld3.js可读的JSON描述的例程。

安装

mpld3 与 Python 2.6-2.7 和 3.3-3.4 兼容。它需要 [matplotlib](https://matplotlib.net.cn) 版本 1.3 和 [jinja2](http://jinja.pocoo.org/) 版本 2.7+。

可选地，mpld3 可以与 [IPython](https://ipython.pythonlang.cn) 笔记本一起使用，并需要 IPython 版本 1.x 或（更佳）版本 2.0+。

此软件包基于 [mplexporter](http://github.com/mpld3/mplexporter) 框架进行爬取和导出 matplotlib 图像。mplexporter 通过 git 子模块捆绑在源分布中。

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

[~]$ python setup.py submodule

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

一旦运行了子模块命令，您就可以使用以下命令本地构建软件包：

[~]$ python setup.py build

或者，使用以下命令将软件包安装到标准 Python 路径：

[~]$ python setup.py install

或者，要安装到其他位置，使用

[~]$ python setup.py install –prefix=/path/to/location/

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

尝试一下

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

要查看更全面的示例集，请参阅 notebooks 目录中可用的 [IPython 笔记本示例](http://nbviewer.ipython.org/github/jakevdp/mpld3/tree/master/notebooks/)。

测试图表

要探索不同图表类型之间 D3 渲染和 matplotlib 渲染的比较，请运行 visualize_tests.py 脚本。这将生成一个包含 D3 渲染与相应的 matplotlib 渲染并排显示的 HTML 页面。

功能

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

• 刻度指定和格式化

• 一些图例功能

• 混合变换，例如 axvlines 和 axhlines 所需的变换

• 双轴（即一个图表上的多个刻度）相关联

如果您觉得这些功能中有任何一个是您想处理的，请随时提交一个 pull request！