Repository files navigation

Matplotlib is a Python 2D plotting library which produces publication-qualityfigures in a variety of hardcopy formats and interactive environments acrossplatforms. Matplotlib can be used in Python scripts, the Python and IPythonshell (à la MATLAB or Mathematica), web application servers, and variousgraphical user interface toolkits.

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

Home page

For installation instructions and requirements, see the INSTALL.rst file or theinstall documentation. If youthink you may want to contribute to matplotlib, check out theguide toworking with the source code.

After installation, you can launch the test suite:

pytest

Or from the Python interpreter:

import matplotlibmatplotlib.test()

Consider readinghttp://matplotlib.org/devel/coding_guide.html#testing for moreinformation. Note that the test suite requires pytest. Please install with pipor your package manager of choice.

Discourse is the discussion forum for general questions and discussions and our recommended starting point.

Our active mailing lists (which are mirrored on Discourse) are:

• Users mailing list:matplotlib-users@python.org
• Announcement mailing list:matplotlib-announce@python.org
• Development mailing list:matplotlib-devel@python.org

Gitter is for coordinating development and asking questions directly relatedto 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 thecontributing guide!

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

If Matplotlib contributes to a project that leads to publication, pleaseacknowledge this by citing Matplotlib.A ready-made citation entry is available.