<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Overview — 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
      };
    </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="index.html" />
    <link rel="next" title="User’s Guide" href="users/index.html" /> 


  </head>
  <body>



<!-- The "Fork me on github" ribbon -->
<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" />
</map>

<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px">
<a href="index.html"><img src="_static/logo2.svg" width="540px" border="0" alt="matplotlib"/></a>
</div>




    <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 class="right" >
          <a href="users/index.html" title="User’s Guide"
             accesskey="N">next</a> |</li>

        <li><a href="index.html">home</a>| </li>
        <li><a href="examples/index.html">examples</a>| </li>
        <li><a href="gallery.html">gallery</a>| </li>
        <li><a href="api/pyplot_summary.html">pyplot</a>| </li>
        <li><a href="#">docs</a> »</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">
</a>

<br/>

Travis-CI: <a href="https://travis-ci.org/matplotlib/matplotlib">
  <img src="https://travis-ci.org/matplotlib/matplotlib.svg?branch=master"/>
</a>
<br/><div class="relations">
<h3>Related Topics</h3>
<ul>
  <li><a href="#">Documentation overview</a><ul>
      <li>Next: <a href="users/index.html" title="next chapter">User’s Guide</a></li>
  </ul></li>
</ul>
</div>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/contents.rst.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </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>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="overview">
<h1>Overview<a class="headerlink" href="#overview" title="Permalink to this headline">¶</a></h1>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Release:</th><td class="field-body">2.0.0</td>
</tr>
<tr class="field-even field"><th class="field-name">Date:</th><td class="field-body">January 16, 2017</td>
</tr>
</tbody>
</table>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="users/index.html">User’s Guide</a><ul>
<li class="toctree-l2"><a class="reference internal" href="users/intro.html">Introduction</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/installing.html">Installing</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/tutorials.html">Tutorials</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/index_text.html">Working with text</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/color_index.html">Colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/customizing.html">Customizing matplotlib</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/interactive.html">Interactive plots</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/examples_index.html">Selected Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/whats_new.html">What’s new in matplotlib</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/github_stats.html">GitHub Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/license.html">License</a></li>
<li class="toctree-l2"><a class="reference internal" href="users/credits.html">Credits</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="api/index.html">The Matplotlib API</a><ul>
<li class="toctree-l2"><a class="reference internal" href="api/pyplot_summary.html">Plotting commands summary</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/api_changes.html">API Changes</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/matplotlib_configuration_api.html">The top level <code class="docutils literal"><span class="pre">matplotlib</span></code> module</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/afm_api.html">afm (Adobe Font Metrics interface)</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/animation_api.html"><code class="docutils literal"><span class="pre">animation</span></code> module</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/artist_api.html"><code class="docutils literal"><span class="pre">artist</span></code> Module</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/axes_api.html"><code class="docutils literal"><span class="pre">Axes</span></code> class</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/axis_api.html">axis and tick API</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/index_backend_api.html">backends</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/cbook_api.html">cbook</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/cm_api.html">cm (colormap)</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/collections_api.html">collections</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/colorbar_api.html">colorbar</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/colors_api.html">colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/dates_api.html">dates</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/dviread.html">dviread</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/figure_api.html">figure</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/finance_api.html">finance</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/font_manager_api.html">font_manager</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/gridspec_api.html">gridspec</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/image_api.html">image</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/legend_api.html">legend and legend_handler</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/lines_api.html">lines</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/markers_api.html">markers</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/mathtext_api.html">mathtext</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/mlab_api.html">mlab</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/offsetbox_api.html">offsetbox</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/patches_api.html">patches</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/path_api.html">path</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/patheffects_api.html">patheffects</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/projections_api.html">projections</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/pyplot_api.html">pyplot</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/rcsetup_api.html">rcsetup</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/sankey_api.html">sankey</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/scale_api.html">scale</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/spines_api.html">spines</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/style_api.html">style</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/text_api.html">text</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/ticker_api.html">ticker</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/tight_layout_api.html">tight_layout</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/transformations.html">Working with transformations</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/tri_api.html">triangular grids</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/type1font.html">type1font</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/units_api.html">units</a></li>
<li class="toctree-l2"><a class="reference internal" href="api/widgets_api.html">widgets</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="faq/index.html">The Matplotlib FAQ</a><ul>
<li class="toctree-l2"><a class="reference internal" href="faq/installing_faq.html">Installation</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq/usage_faq.html">Usage</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq/howto_faq.html">How-To</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq/troubleshooting_faq.html">Troubleshooting</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq/environment_variables_faq.html">Environment Variables</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq/virtualenv_faq.html">Working with Matplotlib in Virtual environments</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq/osx_framework.html">Working with Matplotlib on OSX</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="mpl_toolkits/index.html">Toolkits</a><ul>
<li class="toctree-l2"><a class="reference internal" href="mpl_toolkits/index.html#mapping-toolkits">Mapping Toolkits</a></li>
<li class="toctree-l2"><a class="reference internal" href="mpl_toolkits/index.html#general-toolkits">General Toolkits</a></li>
<li class="toctree-l2"><a class="reference internal" href="mpl_toolkits/index.html#high-level-plotting">High-Level Plotting</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="resources/index.html">External Resources</a><ul>
<li class="toctree-l2"><a class="reference internal" href="resources/index.html#books-chapters-and-articles">Books, Chapters and Articles</a></li>
<li class="toctree-l2"><a class="reference internal" href="resources/index.html#videos">Videos</a></li>
<li class="toctree-l2"><a class="reference internal" href="resources/index.html#tutorials">Tutorials</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="devel/index.html">The Matplotlib Developers’ Guide</a><ul>
<li class="toctree-l2"><a class="reference internal" href="devel/contributing.html">Contributing</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/testing.html">Developer’s tips for testing</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/documenting_mpl.html">Developer’s tips for documenting matplotlib</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/add_new_projection.html">Developer’s guide for creating scales and transformations</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/portable_code.html">Developer’s tips for writing code for Python 2 and 3</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/gitwash/index.html">Working with <em>matplotlib</em> source code</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/coding_guide.html">Reviewers guideline</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/release_guide.html">Release Guide</a></li>
<li class="toctree-l2"><a class="reference internal" href="devel/MEP/index.html">Matplotlib Enhancement Proposals</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="examples/index.html">Matplotlib Examples</a><ul>
<li class="toctree-l2"><a class="reference internal" href="examples/animation/index.html">animation Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/api/index.html">api Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/axes_grid/index.html">axes_grid Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/color/index.html">color Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/event_handling/index.html">event_handling Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/frontpage/index.html">frontpage Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/images_contours_and_fields/index.html">images_contours_and_fields Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/lines_bars_and_markers/index.html">lines_bars_and_markers Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/misc/index.html">misc Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/mplot3d/index.html">mplot3d Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/pie_and_polar_charts/index.html">pie_and_polar_charts Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/pylab_examples/index.html">pylab_examples Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/pyplots/index.html">pyplots Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/scales/index.html">scales Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/shapes_and_collections/index.html">shapes_and_collections Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/showcase/index.html">showcase Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/specialty_plots/index.html">specialty_plots Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/statistics/index.html">statistics Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/style_sheets/index.html">style_sheets Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/subplots_axes_and_figures/index.html">subplots_axes_and_figures Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/tests/index.html">tests Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/text_labels_and_annotations/index.html">text_labels_and_annotations Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/ticks_and_spines/index.html">ticks_and_spines Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/units/index.html">units Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/user_interfaces/index.html">user_interfaces Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="examples/widgets/index.html">widgets Examples</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="glossary/index.html">Glossary</a></li>
</ul>
</div>
<ul class="simple">
<li><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></li>
<li><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module Index</span></a></li>
<li><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></li>
</ul>
</div>


          </div>
        </div>
      </div>

      <div class="clearer"></div>
    </div>
    <div class="footer">
        © 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 Jan 16, 2017.
      Created using <a
href="http://sphinx-doc.org/">Sphinx</a> 1.5.1.
    </div>

<script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

  ga('create', 'UA-55954603-1', 'auto');
  ga('send', 'pageview');

</script>
</body>
<footer>
  <!--Flipcause Integration v3.0// Flipcause Integration Instructions:
Install the following code block once in the website Header (after <head> tag) -->

<style>

.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(http://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);}
}

</style>

<script>

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)){
new_url="https://www.flipcause.com/widget/"+cause_id
window.open(new_url);
}

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";
document.getElementById("fc-myFrame").src="https://www.flipcause.com/widget/"+cause_id;
}
}


function close_window() {
document.getElementById("fc-fade").style.display="none";
document.getElementById("fc-light").style.display="none";
document.getElementById("fc-main").style.display="none";
document.getElementById("fc-close").style.display="none";
document.getElementById("fc-myFrame").style.display="none";
}

</script>

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

<!--END Flipcause Main Integration Code-->
</footer>
</html>