:orphan:

.. title:: Matplotlib documentation

.. module:: matplotlib


##################################
Matplotlib |release| documentation
##################################

Matplotlib is a comprehensive library for creating static, animated,
and interactive visualizations in Python.

************
Installation
************

.. container:: twocol

    .. container::

        Install using `pip <https://pypi.org/project/matplotlib>`__:

        .. code-block:: bash

            pip install matplotlib

    .. container::

        Install using `conda <https://docs.continuum.io/anaconda/>`__:

        .. code-block:: bash

            conda install matplotlib

Further details are available in the :doc:`Installation Guide <users/installing/index>`.


******************
Learning resources
******************

.. panels::

    Tutorials
    ^^^^^^^^^

    - :doc:`Quick-start guide <tutorials/introductory/usage>`
    - :doc:`Plot types <plot_types/index>`
    - `Introductory tutorials <../tutorials/index.html#introductory>`_
    - :doc:`External learning resources <users/resources/index>`

    ---

    How-tos
    ^^^^^^^
    - :doc:`Example gallery <gallery/index>`
    - :doc:`Matplotlib FAQ <faq/index>`

    ---

    Understand how Matplotlib works
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

    - The :ref:`users-guide-explain` in the :doc:`Users guide <users/index>`
    - Many of the :ref:`Intermediate <tutorials-intermediate>` and
      :ref:`Advanced <tutorials-advanced>` tutorials
      have explanatory material

    ---

    Reference
    ^^^^^^^^^

    - :doc:`API Reference <api/index>`
    - :doc:`Axes API <api/axes_api>` for most plotting methods
    - :doc:`Figure API <api/figure_api>` for figure-level methods
    - Top-level interfaces to create:

      - Figures (`.pyplot.figure`)
      - Subplots (`.pyplot.subplots`, `.pyplot.subplot_mosaic`)



********************
Third-party packages
********************

There are many `Third-party packages
<https://matplotlib.org/mpl-third-party/>`_ built on top of and extending
Matplotlib.


************
Contributing
************

Matplotlib is a community project maintained for and by its users.  There are many ways
you can help!

- Help other users `on discourse <https://discourse.matplotlib.org>`__
- report a bug or request a feature `on GitHub <https://github.com/matplotlib/matplotlib/issues>`__
- or improve the :ref:`documentation and code <developers-guide-index>`
