[](https://badge.fury.io/py/matplotlib)

[](https://pepy.tech/project/matplotlib)

[](https://numfocus.org)

[](https://discourse.matplotlib.org)

[](https://gitter.im/matplotlib/matplotlib)

[](https://github.com/matplotlib/matplotlib/issues)

[](https://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project)

[](https://github.com/matplotlib/matplotlib/actions?query=workflow%3ATests)

[](https://dev.azure.com/matplotlib/matplotlib/_build/latest?definitionId=1&branchName=main)

[](https://ci.appveyor.com/project/matplotlib/matplotlib)

[](https://codecov.io/github/matplotlib/matplotlib?branch=main)

[](https://lgtm.com/projects/g/matplotlib/matplotlib)


Matplotlib is a comprehensive library for creating static, animated, and

interactive visualizations in Python.

Check out our [home page](https://matplotlib.org/) for more information.


Matplotlib produces publication-quality figures in a variety of hardcopy

formats and interactive environments across platforms. Matplotlib can be

used in Python scripts, Python/IPython shells, web application servers,

and various graphical user interface toolkits.

See the [install

documentation](https://matplotlib.org/stable/users/installing/index.html),

which is generated from `/doc/users/installing/index.rst`

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](https://matplotlib.org/devdocs/devel/contributing.html)!

[Discourse](https://discourse.matplotlib.org/) 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](https://mail.python.org/mailman/listinfo/matplotlib-users)

mailing list: <matplotlib-users@python.org>

- [Announcement](https://mail.python.org/mailman/listinfo/matplotlib-announce)

mailing list: <matplotlib-announce@python.org>

- [Development](https://mail.python.org/mailman/listinfo/matplotlib-devel)

mailing list: <matplotlib-devel@python.org>

[Gitter](https://gitter.im/matplotlib/matplotlib) is for coordinating

development and asking questions directly related to contributing to

matplotlib.

If Matplotlib contributes to a project that leads to publication, please

acknowledge this by citing Matplotlib.

[A ready-made citation

entry](https://matplotlib.org/stable/users/project/citing.html) is

available.

Please note that this repository is participating in a study into

sustainability of open source projects. Data will be gathered about this

repository for approximately the next 12 months, starting from June

Data collected will include number of contributors, number of PRs, time

taken to close/merge these PRs, and issues closed.

For more information, please visit [the informational

page](https://sustainable-open-science-and-software.github.io/) or

download the [participant information

sheet](https://sustainable-open-science-and-software.github.io/assets/PIS_sustainable_software.pdf).