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

<head>

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

<title>figure &mdash; Matplotlib 2.1.2 documentation</title>

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

type="text/css" />

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

type="text/css" />

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

<script type="text/javascript">

var DOCUMENTATION_OPTIONS = {

URL_ROOT: '../',

VERSION: '2.1.2',

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.1.2 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.1.2 documentation" href="../index.html" />

<link rel="up" title="The Matplotlib API" href="index.html" />

<link rel="next" title="matplotlib.figure.AxesStack" href="_as_gen/matplotlib.figure.AxesStack.html" />

<link rel="prev" title="dviread" href="dviread.html" />

<link rel="canonical" href="https://matplotlib.org/stable/api/figure_api.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.1.2). For the latest version see <a href="https://matplotlib.org/stable/api/figure_api.html">https://matplotlib.org/stable/api/figure_api.html</a></div>

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

<a href="../index.html">

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

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

<div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</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="_as_gen/matplotlib.figure.AxesStack.html" title="matplotlib.figure.AxesStack"

accesskey="N">next</a> |</li>

<li class="right" >

<a href="dviread.html" title="dviread"

accesskey="P">previous</a> |</li>

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

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

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

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

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

<li><a href="index.html" accesskey="U">The Matplotlib API</a> &raquo;</li>

</ul>

</div>

<div class="sphinxsidebar">

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

<image src="https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&amp;colorA=E1523D&amp;colorB=007D8A">

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

<img src="../_static/depsy_badge.svg">

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

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

<h3><a href="../contents.html">Table Of Contents</a></h3>

<ul>

<li><a class="reference internal" href="#">figure</a><ul>

<li><a class="reference internal" href="#module-matplotlib.figure"><code class="docutils literal"><span class="pre">matplotlib.figure</span></code></a><ul>

<li><a class="reference internal" href="#classes">Classes</a></li>

<li><a class="reference internal" href="#functions">Functions</a></li>

<div class="relations">

<h3>Related Topics</h3>

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

<li><a href="index.html">The Matplotlib API</a><ul>

<li>Previous: <a href="dviread.html" title="previous chapter">dviread</a></li>

<li>Next: <a href="_as_gen/matplotlib.figure.AxesStack.html" title="next chapter">matplotlib.figure.AxesStack</a></li>

</ul></li>

</ul></li>

<div role="note" aria-label="source link">

<h3>This Page</h3>

<ul class="this-page-menu">

<li><a href="../_sources/api/figure_api.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>

<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="figure">

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

<div class="section" id="module-matplotlib.figure">

<span id="matplotlib-figure"></span><h2><a class="reference internal" href="#module-matplotlib.figure" title="matplotlib.figure"><code class="xref py py-mod docutils literal"><span class="pre">matplotlib.figure</span></code></a><a class="headerlink" href="#module-matplotlib.figure" title="Permalink to this headline">¶</a></h2>

<p>The figure module provides the top-level

<a class="reference internal" href="artist_api.html#matplotlib.artist.Artist" title="matplotlib.artist.Artist"><code class="xref py py-class docutils literal"><span class="pre">Artist</span></code></a>, the <a class="reference internal" href="_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure"><code class="xref py py-class docutils literal"><span class="pre">Figure</span></code></a>, which

contains all the plot elements. The following classes are defined</p>

<dl class="docutils">

<dt><a class="reference internal" href="_as_gen/matplotlib.figure.SubplotParams.html#matplotlib.figure.SubplotParams" title="matplotlib.figure.SubplotParams"><code class="xref py py-class docutils literal"><span class="pre">SubplotParams</span></code></a></dt>

<dd>control the default spacing of the subplots</dd>

<dt><a class="reference internal" href="_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure"><code class="xref py py-class docutils literal"><span class="pre">Figure</span></code></a></dt>

<dd>top level container for all plot elements</dd>

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

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

<table border="1" class="longtable docutils">

<col width="10%" />

<col width="90%" />

<tbody valign="top">

<tr class="row-odd"><td><a class="reference internal" href="_as_gen/matplotlib.figure.AxesStack.html#matplotlib.figure.AxesStack" title="matplotlib.figure.AxesStack"><code class="xref py py-obj docutils literal"><span class="pre">AxesStack</span></code></a>()</td>

<td>Specialization of the Stack to handle all tracking of Axes in a Figure.</td>

<tr class="row-even"><td><a class="reference internal" href="_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure"><code class="xref py py-obj docutils literal"><span class="pre">Figure</span></code></a>([figsize,&nbsp;dpi,&nbsp;facecolor,&nbsp;edgecolor,&nbsp;…])</td>

<td>The Figure instance supports callbacks through a <em>callbacks</em> attribute which is a <a class="reference internal" href="cbook_api.html#matplotlib.cbook.CallbackRegistry" title="matplotlib.cbook.CallbackRegistry"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.cbook.CallbackRegistry</span></code></a> instance.</td>

<tr class="row-odd"><td><a class="reference internal" href="_as_gen/matplotlib.figure.SubplotParams.html#matplotlib.figure.SubplotParams" title="matplotlib.figure.SubplotParams"><code class="xref py py-obj docutils literal"><span class="pre">SubplotParams</span></code></a>([left,&nbsp;bottom,&nbsp;right,&nbsp;top,&nbsp;…])</td>

<td>A class to hold the parameters for a subplot</td>

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

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

<table border="1" class="longtable docutils">

<col width="10%" />

<col width="90%" />

<tbody valign="top">

<tr class="row-odd"><td><a class="reference internal" href="_as_gen/matplotlib.figure.figaspect.html#matplotlib.figure.figaspect" title="matplotlib.figure.figaspect"><code class="xref py py-obj docutils literal"><span class="pre">figaspect</span></code></a>(arg)</td>

<td>Create a figure with specified aspect ratio.</td>

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

Last updated on Feb 08, 2018.

Created using <a

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

</div>