.. _plotting-guide:

***************
Plotting guide
***************

An in-depth, tutorial style guide to the matplotlib plotting
functions, which explains the most important keyword arguments with
examples and figures.

.. _image-plots:

Images
======
:func:`~matplotlib.pyplot.imshow`

TODO; see :ref:`how-to-contribute-docs`.


.. _colormaps-plots:

Colormaps
==========


TODO; see :ref:`how-to-contribute-docs`.

.. _colorbars-plots:

Colorbars
==========

:func:`~matplotlib.pyplot.colorbar`

TODO; see :ref:`how-to-contribute-docs`.

.. _contour-plots:

Contouring
==========

:func:`~matplotlib.pyplot.contour`

TODO; see :ref:`how-to-contribute-docs`.

.. _scatter-plots:

Scatter plots
==============

:func:`~matplotlib.pyplot.scatter`

TODO; see :ref:`how-to-contribute-docs`.

.. _log-plots:

Log plots
==============

:func:`~matplotlib.pyplot.semilogx`, :func:`~matplotlib.pyplot.semilogy` and :func:`~matplotlib.pyplot.loglog`

.. _polar-plots:

Polar plots
==============

:func:`~matplotlib.pyplot.polar`

TODO; see :ref:`how-to-contribute-docs`.

.. _filled-plots:

Filled plots
==============

:func:`~matplotlib.pyplot.fill` and :mod:`~matplotlib.patches`

TODO; see :ref:`how-to-contribute-docs`.

.. _bar-plots:

Bar charts, histograms and errorbars
======================================

:func:`~matplotlib.pyplot.bar`, :func:`~matplotlib.pyplot.barh`,
:func:`~matplotlib.pyplot.errorbar` and
:func:`~matplotlib.pyplot.hist`

TODO; see :ref:`how-to-contribute-docs`.

.. _time-series-plots:

Timeseries plots
==========================

:func:`~matplotlib.pyplot.acorr`, :func:`~matplotlib.pyplot.xcorr`, :func:`~matplotlib.pyplot.psd`, :func:`~matplotlib.pyplot.csd`,
:func:`~matplotlib.pyplot.cohere`, :func:`~matplotlib.pyplot.specgram`
and the windowing and detrending functions in :mod:`matplotlib.mlab`.

TODO; see :ref:`how-to-contribute-docs`.

.. _sparsity-plots:

Sparsity plots
==========================

:func:`~matplotlib.pyplot.spy`

TODO; see :ref:`how-to-contribute-docs`.

.. _boxplots-plots:

Boxplots
==========================

:func:`~matplotlib.pyplot.boxplot`

TODO; see :ref:`how-to-contribute-docs`.

.. _date-plots:

Working with dates
==========================

TODO; see :ref:`how-to-contribute-docs`.

.. _masked-data-plots:

Working with masked/missing data
==================================

TODO; see :ref:`how-to-contribute-docs`.

.. _collections-plots:

Working with collections
==================================

TODO; see :ref:`how-to-contribute-docs`.

.. _legend-plots:

Creating figure and axes legends
==================================
:func:`~matplotlib.pyplot.legend` and :func:`~matplotlib.pyplot.figlegend`

:ref:`plotting-guide-legend`

Annotating plot
===============
:func:`~matplotlib.pyplot.text` and :func:`~matplotlib.pyplot.annotate`

:ref:`plotting-guide-annotation`


