<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<title>Matplotlib: Python plotting &mdash; Matplotlib 3.1.3 documentation</title>

<link rel="stylesheet" href="_static/mpl.css?v3.1.3-2-g782f6ef56"

type="text/css" />

<link rel="stylesheet" href="_static/pygments.css"

type="text/css" />

<link rel="stylesheet" href="_static/graphviz.css" type="text/css" />

<link rel="stylesheet" href="_static/gallery.css" type="text/css" />

<link rel="stylesheet" href="_static/copybutton.css" type="text/css" />

<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>

<script type="text/javascript" src="_static/jquery.js"></script>

<script type="text/javascript" src="_static/underscore.js"></script>

<script type="text/javascript" src="_static/doctools.js"></script>

<script type="text/javascript" src="_static/language_data.js"></script>

<script type="text/javascript" src="_static/clipboard.min.js"></script>

<script type="text/javascript" src="_static/copybutton.js"></script>

<script type="text/javascript">var copybuttonSkipText = '>>> ';</script>

<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>

<link rel="search" type="application/opensearchdescription+xml"

title="Search within Matplotlib 3.1.3 documentation"

href="_static/opensearch.xml"/>

<link rel="shortcut icon" href="_static/favicon.ico"/>

<link rel="index" title="Index" href="genindex.html"

<link rel="search" title="Search" href="search.html"

<link rel="top" title="Matplotlib 3.1.3 documentation" href="#" />

<link rel="canonical" href="https://matplotlib.org/stable/index.html" />

<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>

</head>

<body>

<div id="unreleased-message"> You are reading an old version of the documentation (v3.1.3). For the latest version see <a href="https://matplotlib.org/stable/index.html">https://matplotlib.org/stable/index.html</a></div>

<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px; position: relative;">

<a href="#">

<div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px"><span style="float: right; color: #789; background: white">Version 3.1.3</span></div>

<img src="_static/logo2_compressed.svg" height="125px" border="0" alt="matplotlib"/></a>

<div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div>

<nav class="main-nav">

<ul>

<li><a href="users/installing.html">Installation</a></li>

<li><a href="contents.html">Documentation</a></li>

<li><a href="gallery/index.html">Examples</a></li>

<li><a href="tutorials/index.html">Tutorials</a></li>

<li><a href="devel/index.html">Contributing</a></li>

<li class="nav-right">

<form class="search" action="search.html" method="get">

<input type="text" name="q" aria-labelledby="searchlabel" placeholder="Search"/>

</form>

</li>

</ul>

</nav>

<div class="related">

<h3>Navigation</h3>

<ul>

<li class="right" style="margin-right: 10px">

<a href="genindex.html" title="General Index"

accesskey="I">index</a></li>

<li class="right" >

<a href="py-modindex.html" title="Python Module Index"

>modules</a> |</li>

<li><a href="#">home</a>|&nbsp;</li>

<li><a href="contents.html">contents</a> &raquo;</li>

</ul>

</div>

<div class="sphinxsidebar">

<div class="sphinxsidebarwrapper"><div class="sidebar-announcement">

<p>Matplotlib 3.0 is Python 3 only.</p>

<p>For Python 2 support, Matplotlib 2.2.x will be continued as a LTS release

and updated with bugfixes until January 1, 2020.</p>

</div><div class="sidebar-versions">

function getSnippet(id, url) {

var req = false;

// For Safari, Firefox, and other non-MS browsers

if (window.XMLHttpRequest) {

try {

req = new XMLHttpRequest();

} catch (e) {

req = false;

}

} else if (window.ActiveXObject) {

// For Internet Explorer on Windows

try {

req = new ActiveXObject("Msxml2.XMLHTTP");

} catch (e) {

try {

req = new ActiveXObject("Microsoft.XMLHTTP");

} catch (e) {

req = false;

}

}

}

var element = document.querySelector(".sidebar-versions");

if (req) {

// Synchronous request, wait till we have it all

req.open('GET', url, false);

req.send(null);

if (req.status == 200) {

element.innerHTML = req.responseText;

} else {

element.innerHTML = "<mark>Could not find Snippet to insert at " + url + "</mark>"

}

}

getSnippet('other_versions', '/versions.html');

<div id="sidebar-donations">

<a href="https://numfocus.org/donate-to-matplotlib" target="_blank"> <div class="donate_button" >Support Matplotlib</div></a>

</div>

</div>

<div class="document">

<div class="documentwrapper">

<div class="bodywrapper">

<div class="body">

<p>Matplotlib is a Python 2D plotting library which 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 <a class="reference external" href="http://ipython.org">IPython</a>

shells, the <a class="reference external" href="http://jupyter.org">Jupyter</a> notebook, web application servers, and four graphical user

interface toolkits.</p>

<div class="responsive_screenshots">

<a href="tutorials/introductory/sample_plots.html">

<div class="responsive_subfig">

<img align="middle" src="_images/sphx_glr_membrane_thumb.png"

border="0" alt="screenshots"/>

</div>

<div class="responsive_subfig">

<img align="middle" src="_images/sphx_glr_histogram_thumb.png"

border="0" alt="screenshots"/>

</div>

<div class="responsive_subfig">

<img align="middle" src="_images/sphx_glr_contour_thumb.png"

border="0" alt="screenshots"/>

</div>

<div class="responsive_subfig">

<img align="middle" src="_images/sphx_glr_3D_thumb.png"

border="0" alt="screenshots"/>

</div>

</a>

<span class="clear_screenshots"></span><p>Matplotlib tries to make easy things easy and hard things possible. You

can generate plots, histograms, power spectra, bar charts, errorcharts,

scatterplots, etc., with just a few lines of code. For examples, see the

<a class="reference internal" href="tutorials/introductory/sample_plots.html"><span class="doc">sample plots</span></a> and <a class="reference internal" href="gallery/index.html"><span class="doc">thumbnail

gallery</span></a>.</p>

<p>For simple plotting the <code class="xref py py-obj docutils literal notranslate"><span class="pre">pyplot</span></code> module provides a MATLAB-like interface,

particularly when combined with IPython. For the power user, you have full

control of line styles, font properties, axes properties, etc, via an object

oriented interface or via a set of functions familiar to MATLAB users.</p>

<div class="section" id="documentation">

<h1>Documentation<a class="headerlink" href="#documentation" title="Permalink to this headline">¶</a></h1>

<p>To get started, read the <a class="reference internal" href="users/index.html"><span class="doc">User's Guide</span></a>.</p>

<p>Trying to learn how to do a particular kind of plot? Check out the

<a class="reference internal" href="gallery/index.html"><span class="doc">examples gallery</span></a> or the <a class="reference internal" href="api/pyplot_summary.html"><span class="doc">list of plotting commands</span></a>.</p>

<div class="section" id="other-learning-resources">

<h2>Other learning resources<a class="headerlink" href="#other-learning-resources" title="Permalink to this headline">¶</a></h2>

<p>There are many <a class="reference internal" href="resources/index.html"><span class="doc">external learning resources</span></a> available

including printed material, videos and tutorials.</p>

<div class="section" id="join-our-community">

<h2>Join our community!<a class="headerlink" href="#join-our-community" title="Permalink to this headline">¶</a></h2>

<p>Matplotlib is a welcoming, inclusive project, and we follow the <a class="reference external" href="http://www.python.org/psf/codeofconduct/">Python

Software Foundation Code of Conduct</a> in everything we do.</p>

<h3>Get help</h3>

<div class="box">

<div class="box-item">

<img src="_static/fa/discourse-brands.svg" alt="Discourse">

<p>Join our community at <a href="https://discourse.matplotlib.org">discourse.matplotlib.org</a>

to get help, discuss contributing &amp; development, and share your work.</p>

</div>

<div class="box-item">

<img src="_static/fa/question-circle-regular.svg" alt="Questions">

<p>If you have questions, be sure to check the <a href="faq/index.html">FAQ</a>,

the <a href="api/index.html">API</a> docs. The full text

<a href="search.html">search</a> is a good way to discover the docs including the many examples.</p>

</div>

<div class="box-item">

<img src="_static/fa/stack-overflow-brands.svg" alt="Stackoverflow">

<p>Check out the Matplotlib tag on <a href="http://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.</p>

</div>

<div class="box-item">

<img src="_static/fa/gitter-brands.svg" alt="Gitter">

<p>Short questions may be posted on the <a href="https://gitter.im/matplotlib/matplotlib">gitter channel</a>.</p>

</div>

<hr class='box-sep'>

<h3>News</h3>

<div class="box">

<div class="box-item">

<img src="_static/fa/plus-square-regular.svg" alt="News">

<p>To keep up to date with what's going on in Matplotlib, see the

<a href="users/whats_new.html">what's new</a> page or browse the

<a href="https://github.com/matplotlib/matplotlib">source code</a>. Anything that could

require changes to your existing code is logged in the

<a href="api/api_changes.html">API changes</a> file.</p>

</div>

<div class="box-item">

<img src="_static/fa/hashtag-solid.svg" alt="Social media">

<p>Tweet us at <a href="https://twitter.com/matplotlib">Twitter</a>!

or see cool plots on <a href="https://www.instagram.com/matplotart/">Instagram</a>!</p>

</div>

<hr class='box-sep'>

<h3>Development</h3>

<div class="box">

<div class="box-item">

<img src="_static/fa/github-brands.svg" alt="Github">

<p>Matplotlib is hosted on <a href="https://github.com/matplotlib/matplotlib">GitHub</a>.</p>

<ul>

<li>File bugs and feature requests on the <a href="https://github.com/matplotlib/matplotlib/issues">issue tracker</a>.</li>

<li><a href="https://github.com/matplotlib/matplotlib/pulls">Pull requests</a> are always welcome.</li>

</ul>

<p>It is a good idea to ping us on <a href="https://discourse.matplotlib.org">Discourse</a> as well.</p>

</div>

<div class="box-item">

<img src="_static/fa/envelope-regular.svg" alt="Mailing lists">

<p>Mailing lists</p>

<ul>

<li><a href="https://mail.python.org/mailman/listinfo/matplotlib-users">matplotlib-users</a> for usage questions</li>

<li><a href="https://mail.python.org/mailman/listinfo/matplotlib-devel">matplotlib-devel</a> for development</li>

<li><a href="https://mail.python.org/mailman/listinfo/matplotlib-announce">matplotlib-announce</a> for project announcements</li>

</ul>

</div>

</div><div class="section" id="toolkits">

<h3>Toolkits<a class="headerlink" href="#toolkits" title="Permalink to this headline">¶</a></h3>

<p>Matplotlib ships with several add-on <a class="reference internal" href="api/toolkits/index.html"><span class="doc">toolkits</span></a>,

including 3d plotting with <code class="xref py py-obj docutils literal notranslate"><span class="pre">mplot3d</span></code>, axes helpers in <code class="xref py py-obj docutils literal notranslate"><span class="pre">axes_grid1</span></code> and axis

helpers in <code class="xref py py-obj docutils literal notranslate"><span class="pre">axisartist</span></code>.</p>

<div class="section" id="third-party-packages">

<h3>Third party packages<a class="headerlink" href="#third-party-packages" title="Permalink to this headline">¶</a></h3>

<p>A large number of <a class="reference internal" href="thirdpartypackages/index.html"><span class="doc">third party packages</span></a>

extend and build on Matplotlib functionality, including several higher-level

plotting interfaces (<a class="reference external" href="https://seaborn.pydata.org">seaborn</a>, <a class="reference external" href="http://holoviews.org">holoviews</a>, <a class="reference external" href="http://ggplot.yhathq.com">ggplot</a>, ...), and two projection

and mapping toolkits (<a class="reference external" href="https://matplotlib.org/basemap">basemap</a> and <a class="reference external" href="https://scitools.org.uk/cartopy/docs/latest">cartopy</a>).</p>

<div class="section" id="citing-matplotlib">

<h3>Citing Matplotlib<a class="headerlink" href="#citing-matplotlib" title="Permalink to this headline">¶</a></h3>

<p>Matplotlib is the brainchild of John Hunter (1968-2012), who, along with its

many contributors, have put an immeasurable amount of time and effort into

producing a piece of software utilized by thousands of scientists worldwide.</p>

<p>If Matplotlib contributes to a project that leads to a scientific publication,

please acknowledge this work by citing the project. A <a class="reference internal" href="citing.html"><span class="doc">ready-made citation

entry</span></a> is available.</p>

<div class="section" id="open-source">

<h3>Open source<a class="headerlink" href="#open-source" title="Permalink to this headline">¶</a></h3>

<a href="https://www.numfocus.org/">

<img src="_static/numfocus_badge.png"

alt="A Fiscally Sponsored Project of NUMFocus"

style="float:right; margin-left:20px" />

</a><p>Matplotlib is a Sponsored Project of NumFOCUS, a 501(c)(3) nonprofit

charity in the United States. NumFOCUS provides Matplotlib with

fiscal, legal, and administrative support to help ensure the health

and sustainability of the project. Visit <a class="reference external" href="nf">numfocus.org</a> for more

information.</p>

<p>Donations to Matplotlib are managed by NumFOCUS. For donors in the

United States, your gift is tax-deductible to the extent provided by

law. As with any donation, you should consult with your tax adviser

about your particular tax situation.</p>

<p>Please consider <a class="reference external" href="https://numfocus.org/donate-to-matplotlib">donating to the Matplotlib project</a> through

the Numfocus organization or to the <a class="reference external" href="https://www.numfocus.org/programs/john-hunter-technology-fellowship/">John Hunter Technology Fellowship</a>.</p>

<p>The <a class="reference internal" href="users/license.html"><span class="doc">Matplotlib license</span></a> is based on the <a class="reference external" href="http://www.python.org/psf/license">Python Software

Foundation (PSF) license</a>.</p>

<p>There is an active developer community and a long list of people who have made

significant <a class="reference internal" href="users/credits.html"><span class="doc">contributions</span></a>.</p>

</div>

</div>

</div>

<div class="clearer"></div>

</div>

<div class="footer">

&copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2018 The Matplotlib development team.

<br />

Last updated on Feb 09, 2020.

Created using

<a href="http://sphinx-doc.org/">Sphinx</a> 1.8.5.

Doc version v3.1.3-2-g782f6ef56.

</div>