Skip to main content

D3 Viewer for Matplotlib

Project description

mpld3: A D3 Viewer for Matplotlib

  • Maintainers: @vladh, @cliffckerr
  • Status: I (@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 for documentation and examples.

You may also see the blog post, or the IPython notebook examples available in the notebooks directory of this repository.

version status downloads build status

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 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 version 2.2.2 and jinja2 version 2.7+.

Optionally, mpld3 can be used with IPython notebook, and requires IPython version 1.x or (preferably) version 2.0+.

This package is based on the 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 setup.py build

or install the package to the standard Python path using:

$ python setup.py install

Or, to install to another location, use

$ python setup.py 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 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!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mpld3-0.5.9.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

mpld3-0.5.9-py3-none-any.whl (201.2 kB view details)

Uploaded Python 3

File details

Details for the file mpld3-0.5.9.tar.gz.

File metadata

  • Download URL: mpld3-0.5.9.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.8

File hashes

Hashes for mpld3-0.5.9.tar.gz
Algorithm Hash digest
SHA256 d8d228b2911132fd0154e2a49543b7f97247f9851cfe468c6b616f452c676158
MD5 b81f354bc1f0355f118919a56c72e204
BLAKE2b-256 d2037d57a65a3cc33b9e7151d96e1944b0f199f7788bf4a9f330a24abec9dfcd

See more details on using hashes here.

File details

Details for the file mpld3-0.5.9-py3-none-any.whl.

File metadata

  • Download URL: mpld3-0.5.9-py3-none-any.whl
  • Upload date:
  • Size: 201.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.8

File hashes

Hashes for mpld3-0.5.9-py3-none-any.whl
Algorithm Hash digest
SHA256 cecdd988b24f8d7c7f362b8f72bb91df1a24b1993dd02a958223918a31c31052
MD5 bb6934c09bb638b67a7f27439274dfdb
BLAKE2b-256 67dc68f18f12b851e1ad67f9eb05c1006592e6e9d231c7307cad504928341bc7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page