<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 2.0.0 documentation</title>

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

type="text/css" />

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

type="text/css" />

<script type="text/javascript">

var DOCUMENTATION_OPTIONS = {

URL_ROOT: './',

VERSION: '2.0.0',

COLLAPSE_INDEX: false,

FILE_SUFFIX: '.html',

HAS_SOURCE: true,

SOURCELINK_SUFFIX: '.txt'

};

</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>

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

title="Search within Matplotlib 2.0.0 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 2.0.0 documentation" href="#" />

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.getElementById(id);

if (req) {

// Synchronous request, wait till we have it all

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

req.send(null);

element.innerHTML = req.responseText;

}

<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 (v2.0.0). For the latest version see <a href="https://matplotlib.org/stable/index.html">https://matplotlib.org/stable/index.html</a></div>

<img style="float: right; margin-bottom: -40px; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png" usemap="#ribbonmap"/>

<map name="ribbonmap">

<area shape="poly" coords="15,0,148,-1,148,135" href="https://github.com/matplotlib/matplotlib" title="Fork me on GitHub" />

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

<a href="#"><img src="_static/logo2.svg" width="540px" border="0" alt="matplotlib"/></a>

<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="examples/index.html">examples</a>|&nbsp;</li>

<li><a href="gallery.html">gallery</a>|&nbsp;</li>

<li><a href="api/pyplot_summary.html">pyplot</a>|&nbsp;</li>

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

</ul>

</div>

<div class="sphinxsidebar">

<div class="sphinxsidebarwrapper">

<a href="http://depsy.org/package/python/matplotlib">

<img src="http://depsy.org/api/package/pypi/matplotlib/badge.svg">

Travis-CI: <a href="https://travis-ci.org/matplotlib/matplotlib">

<img src="https://travis-ci.org/matplotlib/matplotlib.svg?branch=master"/>

<div onclick="open_window('MjI1OA==')" class="donate_button">Support matplotlib</div>

<div onclick="open_window('MjM2OA==')" class="donate_button">Support NumFOCUS</div>

<div id="searchbox" style="display: none" role="search">

<h3>Quick search</h3>

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

<div><input type="text" name="q" /></div>

<div><input type="submit" value="Go" /></div>

<input type="hidden" name="check_keywords" value="yes" />

<input type="hidden" name="area" value="default" />

</form>

<script type="text/javascript">$('#searchbox').show(0);</script>

</div>

</div>

<div class="document">

<div class="documentwrapper">

<div class="bodywrapper">

<div class="body">

<h1>Introduction</h1>

<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

href="http://ipython.org">IPython</a> shell,

the <a href="http://jupyter.org/index.html">jupyter</a> notebook,

web application servers, and four graphical user

interface toolkits.</p>

<div class="responsive_screenshots">

<a a href="users/screenshots.html">

<div class="responsive_subfig">

<img align="middle", src="_static/membrane_frontpage.png", border="0", alt="screenshots"/>

</div>

<div class="responsive_subfig">

<img align="middle", src="_static/histogram_frontpage.png", border="0", alt="screenshots"/>

</div>

<div class="responsive_subfig">

<img align="middle", src="_static/contour_frontpage.png", border="0", alt="screenshots"/>

</div>

<div class="responsive_subfig">

<img align="middle", src="_static/surface3d_frontpage.png", border="0", alt="screenshots"/>

</div>

</a>

</div>

<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 a sampling, see the <a href="users/screenshots.html">screenshots</a>, <a href="gallery.html">thumbnail</a> gallery, and

<a href="examples/index.html">examples</a> directory</p>

<p>For simple plotting the <tt>pyplot</tt> module provides a

MATLAB-like interface, particularly when combined

with <tt>IPython</tt>. 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>

<h1>Installation</h1>

Visit the <a href="users/installing.html">Matplotlib installation instructions</a>.

<h1>Documentation</h1>

This is the documentation for Matplotlib version 2.0.0.

<p id="other_versions"></p>

<script>

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

</script>

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

the <a href="gallery.html">gallery</a>, <a href="examples/index.html">examples</a>,

or the <a href="api/pyplot_summary.html">list of plotting

commands</a>.</p>

<h4>Other learning resources</h4>

<p>There are many <a href="resources/index.html">external learning

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

<h4>Need help?</h4>

<p>Matplotlib is a welcoming, inclusive project, and we try to follow

the <a href="http://www.python.org/psf/codeofconduct/">Python Software

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

<p>Check the <a href="faq/index.html">faq</a>,

the <a href="api/index.html">api</a> docs and

<a href="http://matplotlib.1069221.n5.nabble.com/matplotlib-users-f3.html">mailing list archives</a> for resources.

Join the <a href="https://gitter.im/matplotlib/matplotlib">gitter</a> and the mailing lists: <a href="https://mail.python.org/mailman/listinfo/matplotlib-users">Users</a>,

<a href="https://mail.python.org/mailman/listinfo/matplotlib-announce">Announce</a> and

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

Check out the Matplotlib questions

on <a href="http://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.

The <a href="search.html">search</a> tool searches all of

the documentation, including full text search of over 350 complete

examples which exercise almost every corner of Matplotlib.</p>

<p>You can file bugs, patches and feature requests on the

github

<a href="https://github.com/matplotlib/matplotlib/issues?sort=created&direction=desc&state=open">tracker</a>,

but it is a good idea to ping us on the mailing list too.</p>

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

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

page</a> 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>

<h1>Toolkits</h1>

<p>There are several Matplotlib add-on <a href="mpl_toolkits/index.html">toolkits</a>,

including a choice of two projection and mapping toolkits <a href="http://matplotlib.org/basemap">basemap</a> and

<a href="http://scitools.org.uk/cartopy/docs/latest">cartopy</a>,

3d plotting with <a href="mpl_toolkits/mplot3d/index.html">mplot3d</a>,

axes and axis helpers in <a href="mpl_toolkits/axes_grid/index.html">axes_grid</a>,

several higher-level plotting interfaces

<a href="https://seaborn.github.io/">seaborn</a>,

<a href="http://holoviews.org">holoviews</a>,

<a href="http://ggplot.yhathq.com">ggplot</a>, and more.

</p>

<h1>Citing Matplotlib</h1>

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.

If Matplotlib contributes to a project that leads to a scientific publication,

please acknowledge this work by citing the project. You can use this

<a href="citing.html">ready-made citation entry</a>.

<h1>Open source</h1>

<img src="_static/numfocus_badge.png" alt="A Fiscally Sponsored Project of NUMFocus"

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

Please

consider <a href="https://www.flipcause.com/widget/MjI1OA==">donating

to the Matplotlib project</a> through the Numfocus organization or to

the <a href="http://numfocus.org/johnhunter/">John Hunter Technology Fellowship</a>.

The Matplotlib <a href="users/license.html">license</a> is based on the Python Software Foundation

<a href="http://www.python.org/psf/license">(PSF)</a> license.

There is an active developer community and a long list of people

who have made significant <a href="users/credits.html">contributions</a>.

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

<a href="https://github.com/matplotlib/matplotlib/issues">Issues</a> and

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

are tracked at Github too.

<div class="footnote"><p>

^{<a name="ftn.matlab" href="#matlab">*</a>}

MATLAB is a registered trademark of The MathWorks, Inc.

</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 - 2016 The Matplotlib development team.

Last updated on Feb 20, 2017.

Created using <a

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

</div>

<!--Flipcause Integration v3.0// Flipcause Integration Instructions:

.fc-black_overlay{

display:none; position: fixed; z-index:1000001; top: 0%;left: 0%;width: 100%;height: 100%;

background-color: black; filter: alpha(opacity=50); cursor:pointer; opacity:0.5;

}

.fc-white_content {

opacity:1; display:none; margin-top: -320px; margin-left: -485px; width:970px; height:640px;

position:fixed; top:50%; left:50%; border: none;z-index:1000002;overflow: auto;

}

.fc-main-box{

opacity:1; display:none; margin:15px auto 0 auto; width:930px; position:relative; z-index:1000003;

}

.fc-widget_close{

opacity:1; content:url(https://i1338.photobucket.com/albums/o691/WeCause/X_zpse4a7e538.png);

position:absolute; z-index=1000004; right:-16px; top:-16px; display:block; cursor:pointer;

}

.floating_button{

display: block; margin-top: 0px; margin-left: 0px; width:auto ; height: auto;

position:fixed; z-index:999999; overflow: auto;

}

@keyframes backfadesin {

from { opacity:0; }

to {opacity:.5;}

}

@-moz-keyframes backfadesin {

from { opacity:0; }

to {opacity:.5;}

}

@-webkit-keyframes backfadesin {

from { opacity:0; }

to {opacity:.5;}

}

@-o-keyframes backfadesin {

from { opacity:0; }

to {opacity:.5;}

}

@-ms-keyframes backfadesin {

from { opacity:0; }

to {opacity:.5;}

}

@keyframes fadesin {

0%{ opacity:0; }

50%{ opacity:0; }

75% {opacity: 0; transform: translateY(20px);}

100% {opacity: 1; transform: translateY(0);}

}

@-moz-keyframes fadesin {

0%{ opacity:0; }

50%{ opacity:0; }

75% {opacity: 0; -moz-transform: translateY(20px);}

100% {opacity: 1; -moz-transform: translateY(0);}

}

@-webkit-keyframes fadesin {

0%{ opacity:0; }

50%{ opacity:0; }

75% {opacity: 0; -webkit-transform: translateY(20px);}

100% {opacity: 1; -webkit-transform: translateY(0);}

}

@-o-keyframes fadesin {

0%{ opacity:0; }

50%{ opacity:0; }

75% {opacity: 0; -o-transform: translateY(20px);}

100% {opacity: 1; -o-transform: translateY(0);}

}

@-ms-keyframes fadesin {

0%{ opacity:0; }

50%{ opacity:0; }

75% {opacity: 0; -ms-transform: translateY(20px);}

100% {opacity: 1; -ms-transform: translateY(0);}

}

function open_window(cause_id) {

var protocol=String(document.location.protocol);

var new_url;

if( /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent)){

else {

document.getElementById("fc-fade").style.display = "block";

document.getElementById("fc-fade").style.webkitAnimation = "backfadesin 1s";

document.getElementById("fc-fade").style.animation = "backfadesin 1s";

document.getElementById("fc-fade").style.mozAnimation = "backfadesin 1s";

document.getElementById("fc-light").style.display = "block";

document.getElementById("fc-light").style.webkitAnimation = "fadesin 1.5s";

document.getElementById("fc-light").style.animation = "fadesin 1.5s";

document.getElementById("fc-light").style.mozAnimation = "fadesin 1.5s";

document.getElementById("fc-main").style.display = "block";

document.getElementById("fc-main").style.webkitAnimation = "fadesin 1.5s";

document.getElementById("fc-main").style.animation = "fadesin 1.5s";

document.getElementById("fc-main").style.mozAnimation = "fadesin 1.5s";

document.getElementById("fc-close").style.display = "block";

document.getElementById("fc-close").style.webkitAnimation = "fadesin 1.5s";

document.getElementById("fc-close").style.animation = "fadesin 1.5s";

document.getElementById("fc-close").style.mozAnimation = "fadesin 1.5s";

document.getElementById("fc-myFrame").style.display = "block";

document.getElementById("fc-myFrame").style.webkitAnimation = "fadesin 1.5s";

document.getElementById("fc-myFrame").style.animation = "fadesin 1.5s";

document.getElementById("fc-myFrame").style.mozAnimation = "fadesin 1.5s";

function close_window() {

<div id="fc-fade" class="fc-black_overlay" onclick="close_window()"></div>

<div id="fc-light" class="fc-white_content">

<div id="fc-main" class="fc-main-box">

<div id="fc-close" class="fc-widget_close" onclick="close_window()">

</div><iframe id="fc-myFrame" iframe height="580" width="925" style="border: 0;

border-radius:5px 5px 5px 5px; box-shadow:0 0 8px rgba(0, 0, 0, 0.5);" scrolling="no" src=""></iframe></div>