Skip to content
matplotlib: plotting with Python
Branch: master
Clone or download
dstansby Merge pull request #14026 from astrofrog/fix-plot-directive
Fix bug in plot_directive that caused links to plots in different formats to be missing
Latest commit 4208a71 Apr 24, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Move doc-requirements from root folder Jan 3, 2019
.github Add note about thread safety to FAQ. Jan 27, 2019
LICENSE MNT/DOC: whitespace + updated example heading Aug 13, 2017
ci Simplify travis setup a bit. May 7, 2018
doc Merge pull request #13986 from anntzer/pcolorfast-quadmesh-rgba Apr 23, 2019
examples Remove many unused variables. Apr 23, 2019
extern Backport PR #12548: undef _XOPEN_SOURCE breaks the build in AIX Oct 24, 2018
lib Revert changes to plot_directive that resulted in links to images in … Apr 24, 2019
requirements DOC: pin numpydoc to less than 0.9 Apr 22, 2019
src Merge pull request #13866 from anntzer/argparse Apr 22, 2019
tools Generate Figure method wrappers via Mar 31, 2019
tutorials Fix some documentation links Apr 2, 2019
.appveyor.yml Don't access internet during tests. Apr 1, 2019
.flake8 Improve Conectionstyle Demo Apr 9, 2019
.gitattributes Mark svg files as binary/generated in gitattributes. Sep 22, 2017
.mailmap MNT: add one more alias for tacaswell to mailmap Dec 20, 2018
.travis.yml CI: add additional qt5 deb package on travis Feb 11, 2019
INSTALL.rst Fix remaining links in docs Apr 3, 2019 Remove non-existant files from MANIFEST.IN May 31, 2018
README.rst Add Azure Pipelines build badge (#12891) Nov 26, 2018
azure-pipelines.yml DEBUG-log font-matching results, and print failing logs on CI. Jan 21, 2019
build_alllocal.cmd Don't explicitly pass the default include and lib paths. Feb 27, 2019
matplotlibrc.template moved location of new param in rc template, and modified doc in axes … Mar 29, 2019
pytest.ini Don't access internet during tests. Apr 1, 2019
setup.cfg.template Don't explicitly pass the default include and lib paths. Feb 27, 2019 BLD: remove trailing slash Apr 14, 2019 Don't install tests by default. Apr 23, 2019
tox.ini Fix some more invalid string escapes. Jul 16, 2018


Travis AzurePipelines AppVeyor Codecov LGTM PyPi Gitter NUMFocus GitTutorial


Matplotlib is a Python 2D plotting library which produces publication-quality figures in a variety of hardcopy formats and interactive environments across platforms. Matplotlib can be used in Python scripts, the Python and IPython shell (à la MATLAB or Mathematica), web application servers, and various graphical user interface toolkits.

NOTE: The current master branch is now Python 3 only. Python 2 support is being dropped.

Home page


For installation instructions and requirements, see the INSTALL.rst file or the install documentation. If you think you may want to contribute to matplotlib, check out the guide to working with the source code.


After installation, you can launch the test suite:


Or from the Python interpreter:

import matplotlib

Consider reading for more information. Note that the test suite requires pytest. Please install with pip or your package manager of choice.


matplotlib's communication channels include active mailing lists:

The first is a good starting point for general questions and discussions.

Gitter is for coordinating development and asking questions directly related to contributing to matplotlib.


You've discovered a bug or something else you want to change - excellent!

You've worked out a way to fix it – even better!

You want to tell us about it – best of all!

Start at the contributing guide!

Developer notes are now at Developer Discussions (Note: For technical reasons, this is currently only accessible for matplotlib developers.)

You can’t perform that action at this time.