.. image:: https://github.com/lukelbd/proplot/blob/master/docs/_static/logo_long.png?raw=true
   :width: 1000px

|build-status| |docs| |pypi| |license| |gitter| |pr-welcome|

A comprehensive, easy-to-use `matplotlib <https://matplotlib.org/>`__ wrapper for making beautiful, publication-quality graphics.

Documentation
=============
The documentation is `published on readthedocs <https://proplot.readthedocs.io>`__.

Installation
============

To install or upgrade ProPlot:

.. code-block:: bash

   pip install -U proplot


If you previously used ``pip install git+https://github.com/lukelbd/proplot.git``
to install a development version of proplot,
please run ``pip uninstall`` first.

ProPlot's only hard dependency is `matplotlib <https://matplotlib.org/>`__. The *soft* dependencies are `cartopy <https://scitools.org.uk/cartopy/docs/latest/>`__, `basemap <https://matplotlib.org/basemap/index.html>`__, `xarray <http://xarray.pydata.org>`__, and `pandas <https://pandas.pydata.org>`__. See the documentation for details.


.. |build-status| image:: https://travis-ci.com/lukelbd/proplot.svg?branch=master
   :alt: build status
   :target: https://travis-ci.org/lukelbd/proplot

.. |license| image:: https://img.shields.io/github/license/lukelbd/proplot.svg
   :alt: license
   :target: LICENSE.txt

.. |docs| image:: https://readthedocs.org/projects/proplot/badge/?version=latest
   :alt: docs
   :target: https://proplot.readthedocs.io/en/latest/?badge=latest

.. |pypi| image:: https://img.shields.io/pypi/v/proplot?color=83%20197%2052
   :alt: pypi
   :target: https://pypi.org/project/proplot/

.. |gitter| image:: https://badges.gitter.im/gitterHQ/gitter.svg
   :alt: gitter
   :target: https://gitter.im/pro-plot/community

.. |pr-welcome| image:: https://img.shields.io/badge/PR-Welcome-%23FF8300.svg?
   :alt: PR welcome
   :target: https://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project

..
   |coverage| image:: https://codecov.io/gh/lukelbd/proplot.org/branch/master/graph/badge.svg
   :alt: coverage
   :target: https://codecov.io/gh/lukelbd/proplot.org

..
   |quality| image:: https://api.codacy.com/project/badge/Grade/931d7467c69c40fbb1e97a11d092f9cd
   :alt: quality
   :target: https://www.codacy.com/app/lukelbd/proplot?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=lukelbd/proplot&amp;utm_campaign=Badge_Grade

..
   |hits| image:: http://hits.dwyl.io/lukelbd/lukelbd/proplot.svg
   :alt: hits
   :target: http://hits.dwyl.io/lukelbd/lukelbd/proplot

..
   |contributions| image:: https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat
   :alt: contributions
   :target: https://github.com/lukelbd/issues

..
   |issues| image:: https://img.shields.io/github/issues/lukelbd/proplot.svg
   :alt: issues
   :target: https://github.com/lukelbd/issues
