|Travis|_ |AzurePipelines|_ |AppVeyor|_ |Codecov|_ |LGTM|_ |PyPi|_ |Gitter|_ |NUMFocus|_ |GitTutorial|_
.. |Travis| image:: https://travis-ci.org/matplotlib/matplotlib.svg?branch=master .. _Travis: https://travis-ci.org/matplotlib/matplotlib
.. |AzurePipelines| image:: https://dev.azure.com/matplotlib/matplotlib/apis/build/status/matplotlib.matplotlib?branchName=master .. _AzurePipelines: https://dev.azure.com/matplotlib/matplotlib/build/latest?definitionId=1&branchName=master
.. |AppVeyor| image:: https://ci.appveyor.com/api/projects/status/github/matplotlib/matplotlib?branch=master&svg=true .. _AppVeyor: https://ci.appveyor.com/project/matplotlib/matplotlib
.. |Codecov| image:: https://codecov.io/github/matplotlib/matplotlib/badge.svg?branch=master&service=github .. _Codecov: https://codecov.io/github/matplotlib/matplotlib?branch=master
.. |LGTM| image:: https://img.shields.io/lgtm/grade/python/g/matplotlib/matplotlib.svg?logo=lgtm&logoWidth=18 .. _LGTM: https://lgtm.com/projects/g/matplotlib/matplotlib
.. |PyPi| image:: https://badge.fury.io/py/matplotlib.svg .. _PyPi: https://badge.fury.io/py/matplotlib
.. |Gitter| image:: https://badges.gitter.im/matplotlib/matplotlib.png .. _Gitter: https://gitter.im/matplotlib/matplotlib
.. |NUMFocus| image:: https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A .. _NUMFocus: https://www.numfocus.org
.. |GitTutorial| image:: https://img.shields.io/badge/PR-Welcome-%23FF8300.svg? .. _GitTutorial: https://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project
.. image:: https://matplotlib.org/_static/logo2.svg
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.
.. image:: https://matplotlib.org/static/readmepreview.png
Matplotlib 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, web application servers, and various graphical user interface toolkits.
For installation instructions and requirements, see INSTALL.rst <INSTALL.rst>
_ or the
install <https://matplotlib.org/users/installing.html>
_ documentation.
After installation, launch the test suite::
python -m pytest
Read the testing guide <https://matplotlib.org/devel/testing.html>
_ for more information and alternatives.
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: [email protected]Announcement <https://mail.python.org/mailman/listinfo/matplotlib-announce>
_ mailing list: [email protected]Development <https://mail.python.org/mailman/listinfo/matplotlib-devel>
_ mailing list: [email protected]Gitter_ 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/citing.html>
_ is available.