mpld3: A D3 Viewer for Matplotlib
=================================
- Maintainers: [@vladh](https://github.com/vladh), [@cliffckerr](https://github.com/cliffckerr)
- Status: I ([@vladh](https://github.com/vladh)) am not currently able to dedicate much time to resolving mpld3 issues.
However, I _will_ gladly look at your pull request and review it. Please try your hand at fixing any issues you
may have and sending a PR rather than just filing an issue — most problems don't take as long as you might expect to
figure out!
- Original author: Jake Vanderplas <jakevdp@cs.washington.edu>
- License: BSD 3-clause
This is an interactive D3js-based viewer which brings matplotlib graphics to the browser.
Please visit [http://mpld3.github.io](http://mpld3.github.io) for documentation and examples.
You may also see the [blog post](http://jakevdp.github.io/blog/2013/12/19/a-d3-viewer-for-matplotlib/), or the
[IPython notebook examples](http://nbviewer.ipython.org/github/jakevdp/mpld3/tree/master/notebooks/)
available in the ``notebooks`` directory of this repository.
[](https://pypi.python.org/pypi/mpld3)
[](https://pypi.python.org/pypi/mpld3)
[](https://travis-ci.org/jakevdp/mpld3)
About
-----
mpld3 provides a custom stand-alone javascript library built on D3, which
parses JSON representations of plots. The mpld3 python module provides a
set of routines which parses matplotlib plots (using the
[mplexporter](http://github.com/mpld3/mplexporter) framework) and outputs
the JSON description readable by mpld3.js.
Installation
------------
mpld3 is compatible with python 2.6-2.7 and 3.3-3.4. It requires
[matplotlib](http://matplotlib.org) version 2.2.2 and
[jinja2](http://jinja.pocoo.org/) version 2.7+.
Optionally, mpld3 can be used with [IPython](http://ipython.org) notebook,
and requires IPython version 1.x or (preferably) version 2.0+.
This package is based on the [mplexporter](http://github.com/mpld3/mplexporter)
framework for crawling and exporting matplotlib images. mplexporter is bundled
with the source distribution via git submodule.
Within the git source directory, you can download the mplexporter dependency
and copy it into the mpld3 source directory using the following command:
$ python setup.py submodule
The submodule command is not necessary if you are installing from a distribution
rather than from the git source.
Once the submodule command has been run, you can build the package locally using
$ python -m build
or install the package to the standard Python path using:
$ pip install .
Or, to install to another location, use
$ pip install . --prefix=/path/to/location/
Then make sure your PYTHONPATH environment variable points to this location.
Trying it out
-------------
The package is pure python, and very light-weight. You can take a look at
the notebooks in the examples directory, or run ``create_example.py``, which
will create a set of plots and launch a browser window showing interactive
views of these plots.
For a more comprehensive set of examples, see the
[IPython notebook examples](http://nbviewer.ipython.org/github/jakevdp/mpld3/tree/master/notebooks/) available in the ``notebooks`` directory.
Test Plots
----------
To explore the comparison between D3 renderings and matplotlib renderings for
various plot types, run the script ``visualize_tests.py``. This will generate
an HTML page with the D3 renderings beside corresponding matplotlib renderings.
Features
--------
Many of the core features of matplotlib are already supported. And additionally
there is some extra interactivity provided via the plugin framework. The
following is a non-exhausive list of features that are yet to be supported:
- tick specification & formatting
- some legend features
- blended transforms, such as those required by ``axvlines`` and ``axhlines``
- twin axes (i.e. multiple scales on one plot) tied together
If any of these look like something you'd like to tackle, feel free to submit
a pull request!
Raw data
{
"_id": null,
"home_page": "http://mpld3.github.com",
"name": "mpld3",
"maintainer": "Vlad-Stefan Harbuz",
"docs_url": null,
"requires_python": "",
"maintainer_email": "vlad@vladh.net",
"keywords": "",
"author": "Jake VanderPlas",
"author_email": "jakevdp@cs.washington.edu",
"download_url": "https://files.pythonhosted.org/packages/90/58/19378f4189a034eb3efc17b133426b8551af1d3b2c70d641a63124579629/mpld3-0.5.10.tar.gz",
"platform": null,
"description": "mpld3: A D3 Viewer for Matplotlib\n=================================\n\n- Maintainers: [@vladh](https://github.com/vladh), [@cliffckerr](https://github.com/cliffckerr)\n- Status: I ([@vladh](https://github.com/vladh)) am not currently able to dedicate much time to resolving mpld3 issues.\n However, I _will_ gladly look at your pull request and review it. Please try your hand at fixing any issues you\n may have and sending a PR rather than just filing an issue \u2014 most problems don't take as long as you might expect to\n figure out!\n- Original author: Jake Vanderplas <jakevdp@cs.washington.edu>\n- License: BSD 3-clause\n\nThis is an interactive D3js-based viewer which brings matplotlib graphics to the browser.\nPlease visit [http://mpld3.github.io](http://mpld3.github.io) for documentation and examples.\n\nYou may also see the [blog post](http://jakevdp.github.io/blog/2013/12/19/a-d3-viewer-for-matplotlib/), or the\n[IPython notebook examples](http://nbviewer.ipython.org/github/jakevdp/mpld3/tree/master/notebooks/)\navailable in the ``notebooks`` directory of this repository.\n\n[](https://pypi.python.org/pypi/mpld3)\n[](https://pypi.python.org/pypi/mpld3)\n[](https://travis-ci.org/jakevdp/mpld3)\n\n\nAbout\n-----\nmpld3 provides a custom stand-alone javascript library built on D3, which\nparses JSON representations of plots. The mpld3 python module provides a\nset of routines which parses matplotlib plots (using the \n[mplexporter](http://github.com/mpld3/mplexporter) framework) and outputs\nthe JSON description readable by mpld3.js.\n\n\nInstallation\n------------\nmpld3 is compatible with python 2.6-2.7 and 3.3-3.4. It requires\n[matplotlib](http://matplotlib.org) version 2.2.2 and\n[jinja2](http://jinja.pocoo.org/) version 2.7+.\n\nOptionally, mpld3 can be used with [IPython](http://ipython.org) notebook,\nand requires IPython version 1.x or (preferably) version 2.0+.\n\nThis package is based on the [mplexporter](http://github.com/mpld3/mplexporter)\nframework for crawling and exporting matplotlib images. mplexporter is bundled\nwith the source distribution via git submodule.\n\nWithin the git source directory, you can download the mplexporter dependency\nand copy it into the mpld3 source directory using the following command:\n\n $ python setup.py submodule\n\nThe submodule command is not necessary if you are installing from a distribution\nrather than from the git source.\n\nOnce the submodule command has been run, you can build the package locally using\n\n $ python -m build\n\nor install the package to the standard Python path using:\n\n $ pip install .\n\nOr, to install to another location, use\n\n $ pip install . --prefix=/path/to/location/\n\nThen make sure your PYTHONPATH environment variable points to this location.\n\nTrying it out\n-------------\nThe package is pure python, and very light-weight. You can take a look at\nthe notebooks in the examples directory, or run ``create_example.py``, which\nwill create a set of plots and launch a browser window showing interactive\nviews of these plots.\n\nFor a more comprehensive set of examples, see the\n[IPython notebook examples](http://nbviewer.ipython.org/github/jakevdp/mpld3/tree/master/notebooks/) available in the ``notebooks`` directory.\n\nTest Plots\n----------\nTo explore the comparison between D3 renderings and matplotlib renderings for\nvarious plot types, run the script ``visualize_tests.py``. This will generate\nan HTML page with the D3 renderings beside corresponding matplotlib renderings.\n\nFeatures\n--------\nMany of the core features of matplotlib are already supported. And additionally\nthere is some extra interactivity provided via the plugin framework. The\nfollowing is a non-exhausive list of features that are yet to be supported:\n\n- tick specification & formatting\n- some legend features\n- blended transforms, such as those required by ``axvlines`` and ``axhlines``\n- twin axes (i.e. multiple scales on one plot) tied together\n\nIf any of these look like something you'd like to tackle, feel free to submit\na pull request!\n",
"bugtrack_url": null,
"license": "BSD 3-clause",
"summary": "D3 Viewer for Matplotlib",
"version": "0.5.10",
"project_urls": {
"Download": "http://github.com/jakevdp/mpld3",
"Homepage": "http://mpld3.github.com"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "956ae3691bcc47485f38b09853207c928130571821d187cf174eed5418d45e82",
"md5": "2d03b13858fd2dc11a118d52f1951eb2",
"sha256": "80877acce87ea447380fad7374668737505c8c0684aab05238e7c5dc1fab38c1"
},
"downloads": -1,
"filename": "mpld3-0.5.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d03b13858fd2dc11a118d52f1951eb2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 202561,
"upload_time": "2023-12-23T13:03:02",
"upload_time_iso_8601": "2023-12-23T13:03:02.679360Z",
"url": "https://files.pythonhosted.org/packages/95/6a/e3691bcc47485f38b09853207c928130571821d187cf174eed5418d45e82/mpld3-0.5.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "905819378f4189a034eb3efc17b133426b8551af1d3b2c70d641a63124579629",
"md5": "592aa84de0598d3f165a8a20b69bacaf",
"sha256": "a478eb404fa5212505c59133cf272cd9a94105872e605597720e7f84de38fbc7"
},
"downloads": -1,
"filename": "mpld3-0.5.10.tar.gz",
"has_sig": false,
"md5_digest": "592aa84de0598d3f165a8a20b69bacaf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1027709,
"upload_time": "2023-12-23T13:03:05",
"upload_time_iso_8601": "2023-12-23T13:03:05.159234Z",
"url": "https://files.pythonhosted.org/packages/90/58/19378f4189a034eb3efc17b133426b8551af1d3b2c70d641a63124579629/mpld3-0.5.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-23 13:03:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jakevdp",
"github_project": "mpld3",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "mpld3"
}
JSON
