<!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>Plotting commands summary — Matplotlib 1.2.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: '1.2.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 1.2.0 documentation"
href="../_static/opensearch.xml"/>
<link rel="top" title="Matplotlib 1.2.0 documentation" href="../index.html" />
<link rel="up" title="The Matplotlib API" href="index.html" />
<link rel="next" title="API Changes" href="api_changes.html" />
<link rel="prev" title="The Matplotlib API" href="index.html" />
</head>
<body>
<!-- Piwik -->
<script type="text/javascript">
if ("matplotlib.sourceforge.net" == document.location.hostname ||
"matplotlib.sf.net" == document.location.hostname) {
var pkBaseURL = (("https:" == document.location.protocol) ? "https://apps.sourceforge.net/piwik/matplotlib/" : "http://apps.sourceforge.net/piwik/matplotlib/");
document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
}
</script>
<script type="text/javascript">
if ("matplotlib.sourceforge.net" == document.location.hostname ||
"matplotlib.sf.net" == document.location.hostname) {
piwik_action_name = '';
piwik_idsite = 1;
piwik_url = pkBaseURL + "piwik.php";
piwik_log(piwik_action_name, piwik_idsite, piwik_url);
document.write(unescape('%3Cobject%3E%3Cnoscript%3E%3Cp%3E%3Cimg src="http://apps.sourceforge.net/piwik/matplotlib/piwik.php?idsite=1" alt="piwik"/%3E%3C/p%3E%3C/noscript%3E%3C/object%3E'));
}
</script>
<!-- End Piwik Tag -->
<link rel="shortcut icon" href="_static/favicon.ico">
<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px">
<a href="../index.html"><img src="../_static/logo2.png" 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="api_changes.html" title="API Changes"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="The Matplotlib API"
accesskey="P">previous</a> |</li>
<li><a href="../index.html">home</a>| </li>
<li><a href="../search.html">search</a>| </li>
<li><a href="../examples/index.html">examples</a>| </li>
<li><a href="../gallery.html">gallery</a>| </li>
<li><a href="../contents.html">docs</a> »</li>
<li><a href="index.html" accesskey="U">The Matplotlib API</a> »</li>
</ul>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">The Matplotlib API</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="api_changes.html"
title="next chapter">API Changes</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/api/pyplot_summary.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</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="plotting-commands-summary">
<h1>Plotting commands summary<a class="headerlink" href="#plotting-commands-summary" title="Permalink to this headline">¶</a></h1>
<dl class="function">
<dt id="matplotlib.pyplot.plotting">
<tt class="descclassname">matplotlib.pyplot.</tt><tt class="descname">plotting</tt><big>(</big><big>)</big><a class="headerlink" href="#matplotlib.pyplot.plotting" title="Permalink to this definition">¶</a></dt>
<dd><table border="1" class="docutils">
<colgroup>
<col width="3%" />
<col width="97%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Function</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.acorr" title="matplotlib.pyplot.acorr"><tt class="xref py py-obj docutils literal"><span class="pre">acorr</span></tt></a></td>
<td>Plot the autocorrelation of <em>x</em>.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.annotate" title="matplotlib.pyplot.annotate"><tt class="xref py py-obj docutils literal"><span class="pre">annotate</span></tt></a></td>
<td>Create an annotation: a piece of text referring to a data point.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.arrow" title="matplotlib.pyplot.arrow"><tt class="xref py py-obj docutils literal"><span class="pre">arrow</span></tt></a></td>
<td>Add an arrow to the axes.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.autoscale" title="matplotlib.pyplot.autoscale"><tt class="xref py py-obj docutils literal"><span class="pre">autoscale</span></tt></a></td>
<td>Autoscale the axis view to the data (toggle).</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axes" title="matplotlib.pyplot.axes"><tt class="xref py py-obj docutils literal"><span class="pre">axes</span></tt></a></td>
<td>Add an axes to the figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axhline" title="matplotlib.pyplot.axhline"><tt class="xref py py-obj docutils literal"><span class="pre">axhline</span></tt></a></td>
<td>Add a horizontal line across the axis.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axhspan" title="matplotlib.pyplot.axhspan"><tt class="xref py py-obj docutils literal"><span class="pre">axhspan</span></tt></a></td>
<td>Add a horizontal span (rectangle) across the axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axis" title="matplotlib.pyplot.axis"><tt class="xref py py-obj docutils literal"><span class="pre">axis</span></tt></a></td>
<td>Set or get the axis properties.:: >>> axis() returns the current axes limits <tt class="docutils literal"><span class="pre">[xmin,</span> <span class="pre">xmax,</span> <span class="pre">ymin,</span> <span class="pre">ymax]</span></tt>.:: >>> axis(v) sets the min and max of the x and y axes, with <tt class="docutils literal"><span class="pre">v</span> <span class="pre">=</span> <span class="pre">[xmin,</span> <span class="pre">xmax,</span> <span class="pre">ymin,</span> <span class="pre">ymax]</span></tt>.:: >>> axis(‘off’) turns off the axis lines and labels.:: >>> axis(‘equal’) changes limits of <em>x</em> or <em>y</em> axis so that equal increments of <em>x</em> and <em>y</em> have the same length; a circle is circular.:: >>> axis(‘scaled’) achieves the same result by changing the dimensions of the plot box instead of the axis data limits.:: >>> axis(‘tight’) changes <em>x</em> and <em>y</em> axis limits such that all data is shown.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axvline" title="matplotlib.pyplot.axvline"><tt class="xref py py-obj docutils literal"><span class="pre">axvline</span></tt></a></td>
<td>Add a vertical line across the axes.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axvspan" title="matplotlib.pyplot.axvspan"><tt class="xref py py-obj docutils literal"><span class="pre">axvspan</span></tt></a></td>
<td>Add a vertical span (rectangle) across the axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.bar" title="matplotlib.pyplot.bar"><tt class="xref py py-obj docutils literal"><span class="pre">bar</span></tt></a></td>
<td>Make a bar plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.barbs" title="matplotlib.pyplot.barbs"><tt class="xref py py-obj docutils literal"><span class="pre">barbs</span></tt></a></td>
<td>Plot a 2-D field of barbs.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.barh" title="matplotlib.pyplot.barh"><tt class="xref py py-obj docutils literal"><span class="pre">barh</span></tt></a></td>
<td>Make a horizontal bar plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.box" title="matplotlib.pyplot.box"><tt class="xref py py-obj docutils literal"><span class="pre">box</span></tt></a></td>
<td>Turn the axes box on or off.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.boxplot" title="matplotlib.pyplot.boxplot"><tt class="xref py py-obj docutils literal"><span class="pre">boxplot</span></tt></a></td>
<td>Make a box and whisker plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.broken_barh" title="matplotlib.pyplot.broken_barh"><tt class="xref py py-obj docutils literal"><span class="pre">broken_barh</span></tt></a></td>
<td>Plot horizontal bars.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.cla" title="matplotlib.pyplot.cla"><tt class="xref py py-obj docutils literal"><span class="pre">cla</span></tt></a></td>
<td>Clear the current axes.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.clabel" title="matplotlib.pyplot.clabel"><tt class="xref py py-obj docutils literal"><span class="pre">clabel</span></tt></a></td>
<td>Label a contour plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.clf" title="matplotlib.pyplot.clf"><tt class="xref py py-obj docutils literal"><span class="pre">clf</span></tt></a></td>
<td>Clear the current figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.clim" title="matplotlib.pyplot.clim"><tt class="xref py py-obj docutils literal"><span class="pre">clim</span></tt></a></td>
<td>Set the color limits of the current image.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.close" title="matplotlib.pyplot.close"><tt class="xref py py-obj docutils literal"><span class="pre">close</span></tt></a></td>
<td>Close a figure window.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.cohere" title="matplotlib.pyplot.cohere"><tt class="xref py py-obj docutils literal"><span class="pre">cohere</span></tt></a></td>
<td>Plot the coherence between <em>x</em> and <em>y</em>.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.colorbar" title="matplotlib.pyplot.colorbar"><tt class="xref py py-obj docutils literal"><span class="pre">colorbar</span></tt></a></td>
<td>Add a colorbar to a plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.contour" title="matplotlib.pyplot.contour"><tt class="xref py py-obj docutils literal"><span class="pre">contour</span></tt></a></td>
<td>Plot contours.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.contourf" title="matplotlib.pyplot.contourf"><tt class="xref py py-obj docutils literal"><span class="pre">contourf</span></tt></a></td>
<td>Plot contours.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.csd" title="matplotlib.pyplot.csd"><tt class="xref py py-obj docutils literal"><span class="pre">csd</span></tt></a></td>
<td>Plot cross-spectral density.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.delaxes" title="matplotlib.pyplot.delaxes"><tt class="xref py py-obj docutils literal"><span class="pre">delaxes</span></tt></a></td>
<td>Remove an axes from the current figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.draw" title="matplotlib.pyplot.draw"><tt class="xref py py-obj docutils literal"><span class="pre">draw</span></tt></a></td>
<td>Redraw the current figure.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.errorbar" title="matplotlib.pyplot.errorbar"><tt class="xref py py-obj docutils literal"><span class="pre">errorbar</span></tt></a></td>
<td>Plot an errorbar graph.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figimage" title="matplotlib.pyplot.figimage"><tt class="xref py py-obj docutils literal"><span class="pre">figimage</span></tt></a></td>
<td>Adds a non-resampled image to the figure.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figlegend" title="matplotlib.pyplot.figlegend"><tt class="xref py py-obj docutils literal"><span class="pre">figlegend</span></tt></a></td>
<td>Place a legend in the figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figtext" title="matplotlib.pyplot.figtext"><tt class="xref py py-obj docutils literal"><span class="pre">figtext</span></tt></a></td>
<td>Add text to figure.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure"><tt class="xref py py-obj docutils literal"><span class="pre">figure</span></tt></a></td>
<td>Create a new figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fill" title="matplotlib.pyplot.fill"><tt class="xref py py-obj docutils literal"><span class="pre">fill</span></tt></a></td>
<td>Plot filled polygons.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fill_between" title="matplotlib.pyplot.fill_between"><tt class="xref py py-obj docutils literal"><span class="pre">fill_between</span></tt></a></td>
<td>Make filled polygons between two curves.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fill_betweenx" title="matplotlib.pyplot.fill_betweenx"><tt class="xref py py-obj docutils literal"><span class="pre">fill_betweenx</span></tt></a></td>
<td>Make filled polygons between two horizontal curves.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.findobj" title="matplotlib.pyplot.findobj"><tt class="xref py py-obj docutils literal"><span class="pre">findobj</span></tt></a></td>
<td>Find artist objects.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.gca" title="matplotlib.pyplot.gca"><tt class="xref py py-obj docutils literal"><span class="pre">gca</span></tt></a></td>
<td>Return the current axis instance.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.gcf" title="matplotlib.pyplot.gcf"><tt class="xref py py-obj docutils literal"><span class="pre">gcf</span></tt></a></td>
<td>Return a reference to the current figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.gci" title="matplotlib.pyplot.gci"><tt class="xref py py-obj docutils literal"><span class="pre">gci</span></tt></a></td>
<td>Get the current colorable artist.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.get_figlabels" title="matplotlib.pyplot.get_figlabels"><tt class="xref py py-obj docutils literal"><span class="pre">get_figlabels</span></tt></a></td>
<td>Return a list of existing figure labels.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.get_fignums" title="matplotlib.pyplot.get_fignums"><tt class="xref py py-obj docutils literal"><span class="pre">get_fignums</span></tt></a></td>
<td>Return a list of existing figure numbers.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.grid" title="matplotlib.pyplot.grid"><tt class="xref py py-obj docutils literal"><span class="pre">grid</span></tt></a></td>
<td>Turn the axes grids on or off.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hexbin" title="matplotlib.pyplot.hexbin"><tt class="xref py py-obj docutils literal"><span class="pre">hexbin</span></tt></a></td>
<td>Make a hexagonal binning plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hist" title="matplotlib.pyplot.hist"><tt class="xref py py-obj docutils literal"><span class="pre">hist</span></tt></a></td>
<td>Plot a histogram.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hist2d" title="matplotlib.pyplot.hist2d"><tt class="xref py py-obj docutils literal"><span class="pre">hist2d</span></tt></a></td>
<td>Make a 2D histogram plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hlines" title="matplotlib.pyplot.hlines"><tt class="xref py py-obj docutils literal"><span class="pre">hlines</span></tt></a></td>
<td>Plot horizontal lines.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hold" title="matplotlib.pyplot.hold"><tt class="xref py py-obj docutils literal"><span class="pre">hold</span></tt></a></td>
<td>Set the hold state.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.imread" title="matplotlib.pyplot.imread"><tt class="xref py py-obj docutils literal"><span class="pre">imread</span></tt></a></td>
<td>Read an image from a file into an array.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.imsave" title="matplotlib.pyplot.imsave"><tt class="xref py py-obj docutils literal"><span class="pre">imsave</span></tt></a></td>
<td>Save an array as in image file.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.imshow" title="matplotlib.pyplot.imshow"><tt class="xref py py-obj docutils literal"><span class="pre">imshow</span></tt></a></td>
<td>Display an image on the axes.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ioff" title="matplotlib.pyplot.ioff"><tt class="xref py py-obj docutils literal"><span class="pre">ioff</span></tt></a></td>
<td>Turn interactive mode off.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ion" title="matplotlib.pyplot.ion"><tt class="xref py py-obj docutils literal"><span class="pre">ion</span></tt></a></td>
<td>Turn interactive mode on.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ishold" title="matplotlib.pyplot.ishold"><tt class="xref py py-obj docutils literal"><span class="pre">ishold</span></tt></a></td>
<td>Return the hold status of the current axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.isinteractive" title="matplotlib.pyplot.isinteractive"><tt class="xref py py-obj docutils literal"><span class="pre">isinteractive</span></tt></a></td>
<td>Return status of interactive mode.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.legend" title="matplotlib.pyplot.legend"><tt class="xref py py-obj docutils literal"><span class="pre">legend</span></tt></a></td>
<td>Place a legend on the current axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.locator_params" title="matplotlib.pyplot.locator_params"><tt class="xref py py-obj docutils literal"><span class="pre">locator_params</span></tt></a></td>
<td>Control behavior of tick locators.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.loglog" title="matplotlib.pyplot.loglog"><tt class="xref py py-obj docutils literal"><span class="pre">loglog</span></tt></a></td>
<td>Make a plot with log scaling on both the <em>x</em> and <em>y</em> axis.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.margins" title="matplotlib.pyplot.margins"><tt class="xref py py-obj docutils literal"><span class="pre">margins</span></tt></a></td>
<td>Set or retrieve autoscaling margins.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.matshow" title="matplotlib.pyplot.matshow"><tt class="xref py py-obj docutils literal"><span class="pre">matshow</span></tt></a></td>
<td>Display an array as a matrix in a new figure window.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.minorticks_off" title="matplotlib.pyplot.minorticks_off"><tt class="xref py py-obj docutils literal"><span class="pre">minorticks_off</span></tt></a></td>
<td>Remove minor ticks from the current plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.minorticks_on" title="matplotlib.pyplot.minorticks_on"><tt class="xref py py-obj docutils literal"><span class="pre">minorticks_on</span></tt></a></td>
<td>Display minor ticks on the current plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.over" title="matplotlib.pyplot.over"><tt class="xref py py-obj docutils literal"><span class="pre">over</span></tt></a></td>
<td>Call a function with hold(True).</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pause" title="matplotlib.pyplot.pause"><tt class="xref py py-obj docutils literal"><span class="pre">pause</span></tt></a></td>
<td>Pause for <em>interval</em> seconds.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pcolor" title="matplotlib.pyplot.pcolor"><tt class="xref py py-obj docutils literal"><span class="pre">pcolor</span></tt></a></td>
<td>Create a pseudocolor plot of a 2-D array.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pcolormesh" title="matplotlib.pyplot.pcolormesh"><tt class="xref py py-obj docutils literal"><span class="pre">pcolormesh</span></tt></a></td>
<td>Plot a quadrilateral mesh.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pie" title="matplotlib.pyplot.pie"><tt class="xref py py-obj docutils literal"><span class="pre">pie</span></tt></a></td>
<td>Plot a pie chart.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot"><tt class="xref py py-obj docutils literal"><span class="pre">plot</span></tt></a></td>
<td>Plot lines and/or markers to the <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><tt class="xref py py-class docutils literal"><span class="pre">Axes</span></tt></a>.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.plot_date" title="matplotlib.pyplot.plot_date"><tt class="xref py py-obj docutils literal"><span class="pre">plot_date</span></tt></a></td>
<td>Plot with data with dates.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.plotfile" title="matplotlib.pyplot.plotfile"><tt class="xref py py-obj docutils literal"><span class="pre">plotfile</span></tt></a></td>
<td>Plot the data in in a file.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.polar" title="matplotlib.pyplot.polar"><tt class="xref py py-obj docutils literal"><span class="pre">polar</span></tt></a></td>
<td>Make a polar plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.psd" title="matplotlib.pyplot.psd"><tt class="xref py py-obj docutils literal"><span class="pre">psd</span></tt></a></td>
<td>Plot the power spectral density.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.quiver" title="matplotlib.pyplot.quiver"><tt class="xref py py-obj docutils literal"><span class="pre">quiver</span></tt></a></td>
<td>Plot a 2-D field of arrows.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.quiverkey" title="matplotlib.pyplot.quiverkey"><tt class="xref py py-obj docutils literal"><span class="pre">quiverkey</span></tt></a></td>
<td>Add a key to a quiver plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rc" title="matplotlib.pyplot.rc"><tt class="xref py py-obj docutils literal"><span class="pre">rc</span></tt></a></td>
<td>Set the current rc params.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rcdefaults" title="matplotlib.pyplot.rcdefaults"><tt class="xref py py-obj docutils literal"><span class="pre">rcdefaults</span></tt></a></td>
<td>Restore the default rc params.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rgrids" title="matplotlib.pyplot.rgrids"><tt class="xref py py-obj docutils literal"><span class="pre">rgrids</span></tt></a></td>
<td>Get or set the radial gridlines on a polar plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.savefig" title="matplotlib.pyplot.savefig"><tt class="xref py py-obj docutils literal"><span class="pre">savefig</span></tt></a></td>
<td>Save the current figure.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.sca" title="matplotlib.pyplot.sca"><tt class="xref py py-obj docutils literal"><span class="pre">sca</span></tt></a></td>
<td>Set the current Axes instance to <em>ax</em>.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.scatter" title="matplotlib.pyplot.scatter"><tt class="xref py py-obj docutils literal"><span class="pre">scatter</span></tt></a></td>
<td>Make a scatter plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.sci" title="matplotlib.pyplot.sci"><tt class="xref py py-obj docutils literal"><span class="pre">sci</span></tt></a></td>
<td>Set the current image.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.semilogx" title="matplotlib.pyplot.semilogx"><tt class="xref py py-obj docutils literal"><span class="pre">semilogx</span></tt></a></td>
<td>Make a plot with log scaling on the <em>x</em> axis.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.semilogy" title="matplotlib.pyplot.semilogy"><tt class="xref py py-obj docutils literal"><span class="pre">semilogy</span></tt></a></td>
<td>Make a plot with log scaling on the <em>y</em> axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.set_cmap" title="matplotlib.pyplot.set_cmap"><tt class="xref py py-obj docutils literal"><span class="pre">set_cmap</span></tt></a></td>
<td>Set the default colormap.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.setp" title="matplotlib.pyplot.setp"><tt class="xref py py-obj docutils literal"><span class="pre">setp</span></tt></a></td>
<td>Set a property on an artist object.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.show" title="matplotlib.pyplot.show"><tt class="xref py py-obj docutils literal"><span class="pre">show</span></tt></a></td>
<td>Display a figure.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.specgram" title="matplotlib.pyplot.specgram"><tt class="xref py py-obj docutils literal"><span class="pre">specgram</span></tt></a></td>
<td>Plot a spectrogram.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.spy" title="matplotlib.pyplot.spy"><tt class="xref py py-obj docutils literal"><span class="pre">spy</span></tt></a></td>
<td>Plot the sparsity pattern on a 2-D array.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.stackplot" title="matplotlib.pyplot.stackplot"><tt class="xref py py-obj docutils literal"><span class="pre">stackplot</span></tt></a></td>
<td>Draws a stacked area plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.stem" title="matplotlib.pyplot.stem"><tt class="xref py py-obj docutils literal"><span class="pre">stem</span></tt></a></td>
<td>Create a stem plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.step" title="matplotlib.pyplot.step"><tt class="xref py py-obj docutils literal"><span class="pre">step</span></tt></a></td>
<td>Make a step plot.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.streamplot" title="matplotlib.pyplot.streamplot"><tt class="xref py py-obj docutils literal"><span class="pre">streamplot</span></tt></a></td>
<td>Draws streamlines of a vector flow.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplot" title="matplotlib.pyplot.subplot"><tt class="xref py py-obj docutils literal"><span class="pre">subplot</span></tt></a></td>
<td>Create a new axes (subplot).</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplot2grid" title="matplotlib.pyplot.subplot2grid"><tt class="xref py py-obj docutils literal"><span class="pre">subplot2grid</span></tt></a></td>
<td>Create a subplot in a grid.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplot_tool" title="matplotlib.pyplot.subplot_tool"><tt class="xref py py-obj docutils literal"><span class="pre">subplot_tool</span></tt></a></td>
<td>Launch a subplot tool window for a figure.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplots" title="matplotlib.pyplot.subplots"><tt class="xref py py-obj docutils literal"><span class="pre">subplots</span></tt></a></td>
<td>Create a figure with a set of subplots already made.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplots_adjust" title="matplotlib.pyplot.subplots_adjust"><tt class="xref py py-obj docutils literal"><span class="pre">subplots_adjust</span></tt></a></td>
<td>Tune the subplot layout.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.suptitle" title="matplotlib.pyplot.suptitle"><tt class="xref py py-obj docutils literal"><span class="pre">suptitle</span></tt></a></td>
<td>Add a centered title to the figure.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.switch_backend" title="matplotlib.pyplot.switch_backend"><tt class="xref py py-obj docutils literal"><span class="pre">switch_backend</span></tt></a></td>
<td>Switch the default backend.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.table" title="matplotlib.pyplot.table"><tt class="xref py py-obj docutils literal"><span class="pre">table</span></tt></a></td>
<td>Add a table to the current axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.text" title="matplotlib.pyplot.text"><tt class="xref py py-obj docutils literal"><span class="pre">text</span></tt></a></td>
<td>Add text to the axes.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.thetagrids" title="matplotlib.pyplot.thetagrids"><tt class="xref py py-obj docutils literal"><span class="pre">thetagrids</span></tt></a></td>
<td>Get or set the theta locations of the gridlines in a polar plot.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tick_params" title="matplotlib.pyplot.tick_params"><tt class="xref py py-obj docutils literal"><span class="pre">tick_params</span></tt></a></td>
<td>Change the appearance of ticks and tick labels.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ticklabel_format" title="matplotlib.pyplot.ticklabel_format"><tt class="xref py py-obj docutils literal"><span class="pre">ticklabel_format</span></tt></a></td>
<td>Change the <a class="reference internal" href="ticker_api.html#matplotlib.ticker.ScalarFormatter" title="matplotlib.ticker.ScalarFormatter"><tt class="xref py py-obj docutils literal"><span class="pre">ScalarFormatter</span></tt></a> used by default for linear axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tight_layout" title="matplotlib.pyplot.tight_layout"><tt class="xref py py-obj docutils literal"><span class="pre">tight_layout</span></tt></a></td>
<td>Automatically adjust subplot parameters to give specified padding.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.title" title="matplotlib.pyplot.title"><tt class="xref py py-obj docutils literal"><span class="pre">title</span></tt></a></td>
<td>Set the title of the current axis.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tricontour" title="matplotlib.pyplot.tricontour"><tt class="xref py py-obj docutils literal"><span class="pre">tricontour</span></tt></a></td>
<td>Draw contours on an unstructured triangular grid.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tricontourf" title="matplotlib.pyplot.tricontourf"><tt class="xref py py-obj docutils literal"><span class="pre">tricontourf</span></tt></a></td>
<td>Draw contours on an unstructured triangular grid.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tripcolor" title="matplotlib.pyplot.tripcolor"><tt class="xref py py-obj docutils literal"><span class="pre">tripcolor</span></tt></a></td>
<td>Create a pseudocolor plot of an unstructured triangular grid.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.triplot" title="matplotlib.pyplot.triplot"><tt class="xref py py-obj docutils literal"><span class="pre">triplot</span></tt></a></td>
<td>Draw a unstructured triangular grid as lines and/or markers.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.twinx" title="matplotlib.pyplot.twinx"><tt class="xref py py-obj docutils literal"><span class="pre">twinx</span></tt></a></td>
<td>Make a second axes that shares the <em>x</em>-axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.twiny" title="matplotlib.pyplot.twiny"><tt class="xref py py-obj docutils literal"><span class="pre">twiny</span></tt></a></td>
<td>Make a second axes that shares the <em>y</em>-axis.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.vlines" title="matplotlib.pyplot.vlines"><tt class="xref py py-obj docutils literal"><span class="pre">vlines</span></tt></a></td>
<td>Plot vertical lines.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xcorr" title="matplotlib.pyplot.xcorr"><tt class="xref py py-obj docutils literal"><span class="pre">xcorr</span></tt></a></td>
<td>Plot the cross correlation between <em>x</em> and <em>y</em>.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xlabel" title="matplotlib.pyplot.xlabel"><tt class="xref py py-obj docutils literal"><span class="pre">xlabel</span></tt></a></td>
<td>Set the <em>x</em> axis label of the current axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xlim" title="matplotlib.pyplot.xlim"><tt class="xref py py-obj docutils literal"><span class="pre">xlim</span></tt></a></td>
<td>Get or set the <em>x</em> limits of the current axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xscale" title="matplotlib.pyplot.xscale"><tt class="xref py py-obj docutils literal"><span class="pre">xscale</span></tt></a></td>
<td>Set the scaling of the <em>x</em>-axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xticks" title="matplotlib.pyplot.xticks"><tt class="xref py py-obj docutils literal"><span class="pre">xticks</span></tt></a></td>
<td>Get or set the <em>x</em>-limits of the current tick locations and labels.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ylabel" title="matplotlib.pyplot.ylabel"><tt class="xref py py-obj docutils literal"><span class="pre">ylabel</span></tt></a></td>
<td>Set the <em>y</em> axis label of the current axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ylim" title="matplotlib.pyplot.ylim"><tt class="xref py py-obj docutils literal"><span class="pre">ylim</span></tt></a></td>
<td>Get or set the <em>y</em>-limits of the current axes.</td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.yscale" title="matplotlib.pyplot.yscale"><tt class="xref py py-obj docutils literal"><span class="pre">yscale</span></tt></a></td>
<td>Set the scaling of the <em>y</em>-axis.</td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.yticks" title="matplotlib.pyplot.yticks"><tt class="xref py py-obj docutils literal"><span class="pre">yticks</span></tt></a></td>
<td>Get or set the <em>y</em>-limits of the current tick locations and labels.</td>
</tr>
</tbody>
</table>
</dd></dl>
<dl class="function">
<dt id="matplotlib.pyplot.colormaps">
<tt class="descclassname">matplotlib.pyplot.</tt><tt class="descname">colormaps</tt><big>(</big><big>)</big><a class="headerlink" href="#matplotlib.pyplot.colormaps" title="Permalink to this definition">¶</a></dt>
<dd><p>Matplotlib provides a number of colormaps, and others can be added using
<tt class="xref py py-func docutils literal"><span class="pre">register_cmap()</span></tt>. This function documents the built-in colormaps,
and will also return a list of all registered colormaps if called.</p>
<p>You can set the colormap for an image, pcolor, scatter, etc,
using a keyword argument:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">imshow</span><span class="p">(</span><span class="n">X</span><span class="p">,</span> <span class="n">cmap</span><span class="o">=</span><span class="n">cm</span><span class="o">.</span><span class="n">hot</span><span class="p">)</span>
</pre></div>
</div>
<p>or using the <a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.set_cmap" title="matplotlib.pyplot.set_cmap"><tt class="xref py py-func docutils literal"><span class="pre">set_cmap()</span></tt></a> function:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">imshow</span><span class="p">(</span><span class="n">X</span><span class="p">)</span>
<span class="n">pyplot</span><span class="o">.</span><span class="n">set_cmap</span><span class="p">(</span><span class="s">'hot'</span><span class="p">)</span>
<span class="n">pyplot</span><span class="o">.</span><span class="n">set_cmap</span><span class="p">(</span><span class="s">'jet'</span><span class="p">)</span>
</pre></div>
</div>
<p>In interactive mode, <a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.set_cmap" title="matplotlib.pyplot.set_cmap"><tt class="xref py py-func docutils literal"><span class="pre">set_cmap()</span></tt></a> will update the colormap post-hoc,
allowing you to see which one works best for your data.</p>
<p>All built-in colormaps can be reversed by appending <tt class="docutils literal"><span class="pre">_r</span></tt>: For instance,
<tt class="docutils literal"><span class="pre">gray_r</span></tt> is the reverse of <tt class="docutils literal"><span class="pre">gray</span></tt>.</p>
<p>There are several common color schemes used in visualization:</p>
<dl class="docutils">
<dt>Sequential schemes</dt>
<dd>for unipolar data that progresses from low to high</dd>
<dt>Diverging schemes</dt>
<dd>for bipolar data that emphasizes positive or negative deviations from a
central value</dd>
<dt>Cyclic schemes</dt>
<dd>meant for plotting values that wrap around at the
endpoints, such as phase angle, wind direction, or time of day</dd>
<dt>Qualitative schemes</dt>
<dd>for nominal data that has no inherent ordering, where color is used
only to distinguish categories</dd>
</dl>
<p>The base colormaps are (with the exception of <a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.spectral" title="matplotlib.pyplot.spectral"><tt class="xref py py-obj docutils literal"><span class="pre">spectral</span></tt></a>) derived from
those of the same name provided with Matlab:</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="13%" />
<col width="87%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>autumn</td>
<td>sequential linearly-increasing shades of red-orange-yellow</td>
</tr>
<tr class="row-odd"><td>bone</td>
<td>sequential increasing black-white color map with
a tinge of blue, to emulate X-ray film</td>
</tr>
<tr class="row-even"><td>cool</td>
<td>linearly-decreasing shades of cyan-magenta</td>
</tr>
<tr class="row-odd"><td>copper</td>
<td>sequential increasing shades of black-copper</td>
</tr>
<tr class="row-even"><td>flag</td>
<td>repetitive red-white-blue-black pattern (not cyclic at
endpoints)</td>
</tr>
<tr class="row-odd"><td>gray</td>
<td>sequential linearly-increasing black-to-white
grayscale</td>
</tr>
<tr class="row-even"><td>hot</td>
<td>sequential black-red-yellow-white, to emulate blackbody
radiation from an object at increasing temperatures</td>
</tr>
<tr class="row-odd"><td>hsv</td>
<td>cyclic red-yellow-green-cyan-blue-magenta-red, formed
by changing the hue component in the HSV color space</td>
</tr>
<tr class="row-even"><td>jet</td>
<td>a spectral map with dark endpoints, blue-cyan-yellow-red;
based on a fluid-jet simulation by NCSA <a class="footnote-reference" href="#id5" id="id1">[1]</a></td>
</tr>
<tr class="row-odd"><td>pink</td>
<td>sequential increasing pastel black-pink-white, meant
for sepia tone colorization of photographs</td>
</tr>
<tr class="row-even"><td>prism</td>
<td>repetitive red-yellow-green-blue-purple-...-green pattern
(not cyclic at endpoints)</td>
</tr>
<tr class="row-odd"><td>spring</td>
<td>linearly-increasing shades of magenta-yellow</td>
</tr>
<tr class="row-even"><td>summer</td>
<td>sequential linearly-increasing shades of green-yellow</td>
</tr>
<tr class="row-odd"><td>winter</td>
<td>linearly-increasing shades of blue-green</td>
</tr>
<tr class="row-even"><td>spectral</td>
<td>black-purple-blue-green-yellow-red-white spectrum</td>
</tr>
</tbody>
</table>
</div></blockquote>
<p>For the above list only, you can also set the colormap using the
corresponding pylab shortcut interface function, similar to Matlab:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">imshow</span><span class="p">(</span><span class="n">X</span><span class="p">)</span>
<span class="n">hot</span><span class="p">()</span>
<span class="n">jet</span><span class="p">()</span>
</pre></div>
</div>
<p>The next set of palettes are from the <a class="reference external" href="http://yorick.sourceforge.net/index.php">Yorick scientific visualisation
package</a>, an evolution of
the GIST package, both by David H. Munro:</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="18%" />
<col width="82%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>gist_earth</td>
<td>mapmaker’s colors from dark blue deep ocean to green
lowlands to brown highlands to white mountains</td>
</tr>
<tr class="row-odd"><td>gist_heat</td>
<td>sequential increasing black-red-orange-white, to emulate
blackbody radiation from an iron bar as it grows hotter</td>
</tr>
<tr class="row-even"><td>gist_ncar</td>
<td>pseudo-spectral black-blue-green-yellow-red-purple-white
colormap from National Center for Atmospheric
Research <a class="footnote-reference" href="#id6" id="id2">[2]</a></td>
</tr>
<tr class="row-odd"><td>gist_rainbow</td>
<td>runs through the colors in spectral order from red to
violet at full saturation (like <em>hsv</em> but not cyclic)</td>
</tr>
<tr class="row-even"><td>gist_stern</td>
<td>“Stern special” color table from Interactive Data
Language software</td>
</tr>
</tbody>
</table>
</div></blockquote>
<p>The following colormaps are based on the <a class="reference external" href="http://colorbrewer.org">ColorBrewer</a> color specifications and designs developed by
Cynthia Brewer:</p>
<p>ColorBrewer Diverging (luminance is highest at the midpoint, and
decreases towards differently-colored endpoints):</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="19%" />
<col width="81%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>BrBG</td>
<td>brown, white, blue-green</td>
</tr>
<tr class="row-odd"><td>PiYG</td>
<td>pink, white, yellow-green</td>
</tr>
<tr class="row-even"><td>PRGn</td>
<td>purple, white, green</td>
</tr>
<tr class="row-odd"><td>PuOr</td>
<td>orange, white, purple</td>
</tr>
<tr class="row-even"><td>RdBu</td>
<td>red, white, blue</td>
</tr>
<tr class="row-odd"><td>RdGy</td>
<td>red, white, gray</td>
</tr>
<tr class="row-even"><td>RdYlBu</td>
<td>red, yellow, blue</td>
</tr>
<tr class="row-odd"><td>RdYlGn</td>
<td>red, yellow, green</td>
</tr>
<tr class="row-even"><td>Spectral</td>
<td>red, orange, yellow, green, blue</td>
</tr>
</tbody>
</table>
</div></blockquote>
<p>ColorBrewer Sequential (luminance decreases monotonically):</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="18%" />
<col width="82%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Blues</td>
<td>white to dark blue</td>
</tr>
<tr class="row-odd"><td>BuGn</td>
<td>white, light blue, dark green</td>
</tr>
<tr class="row-even"><td>BuPu</td>
<td>white, light blue, dark purple</td>
</tr>
<tr class="row-odd"><td>GnBu</td>
<td>white, light green, dark blue</td>
</tr>
<tr class="row-even"><td>Greens</td>
<td>white to dark green</td>
</tr>
<tr class="row-odd"><td>Greys</td>
<td>white to black (not linear)</td>
</tr>
<tr class="row-even"><td>Oranges</td>
<td>white, orange, dark brown</td>
</tr>
<tr class="row-odd"><td>OrRd</td>
<td>white, orange, dark red</td>
</tr>
<tr class="row-even"><td>PuBu</td>
<td>white, light purple, dark blue</td>
</tr>
<tr class="row-odd"><td>PuBuGn</td>
<td>white, light purple, dark green</td>
</tr>
<tr class="row-even"><td>PuRd</td>
<td>white, light purple, dark red</td>
</tr>
<tr class="row-odd"><td>Purples</td>
<td>white to dark purple</td>
</tr>
<tr class="row-even"><td>RdPu</td>
<td>white, pink, dark purple</td>
</tr>
<tr class="row-odd"><td>Reds</td>
<td>white to dark red</td>
</tr>
<tr class="row-even"><td>YlGn</td>
<td>light yellow, dark green</td>
</tr>
<tr class="row-odd"><td>YlGnBu</td>
<td>light yellow, light green, dark blue</td>
</tr>
<tr class="row-even"><td>YlOrBr</td>
<td>light yellow, orange, dark brown</td>
</tr>
<tr class="row-odd"><td>YlOrRd</td>
<td>light yellow, orange, dark red</td>
</tr>
</tbody>
</table>
</div></blockquote>
<p>ColorBrewer Qualitative:</p>
<p>(For plotting nominal data, <tt class="xref py py-class docutils literal"><span class="pre">ListedColormap</span></tt> should be used,
not <tt class="xref py py-class docutils literal"><span class="pre">LinearSegmentedColormap</span></tt>. Different sets of colors are
recommended for different numbers of categories. These continuous
versions of the qualitative schemes may be removed or converted in the
future.)</p>
<ul class="simple">
<li>Accent</li>
<li>Dark2</li>
<li>Paired</li>
<li>Pastel1</li>
<li>Pastel2</li>
<li>Set1</li>
<li>Set2</li>
<li>Set3</li>
</ul>
<p>Other miscellaneous schemes:</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="14%" />
<col width="86%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>afmhot</td>
<td>sequential black-orange-yellow-white blackbody
spectrum, commonly used in atomic force microscopy</td>
</tr>
<tr class="row-odd"><td>brg</td>
<td>blue-red-green</td>
</tr>
<tr class="row-even"><td>bwr</td>
<td>diverging blue-white-red</td>
</tr>
<tr class="row-odd"><td>coolwarm</td>
<td>diverging blue-gray-red, meant to avoid issues with 3D
shading, color blindness, and ordering of colors <a class="footnote-reference" href="#id7" id="id3">[3]</a></td>
</tr>
<tr class="row-even"><td>CMRmap</td>
<td>“Default colormaps on color images often reproduce to
confusing grayscale images. The proposed colormap
maintains an aesthetically pleasing color image that
automatically reproduces to a monotonic grayscale with
discrete, quantifiable saturation levels.” <a class="footnote-reference" href="#id8" id="id4">[4]</a></td>
</tr>
<tr class="row-odd"><td>cubehelix</td>
<td>Unlike most other color schemes cubehelix was designed
by D.A. Green to be monotonically increasing in terms
of perceived brightness. Also, when printed on a black
and white postscript printer, the scheme results in a
greyscale with monotonically increasing brightness.
This color scheme is named cubehelix because the r,g,b
values produced can be visualised as a squashed helix
around the diagonal in the r,g,b color cube.</td>
</tr>
<tr class="row-even"><td>gnuplot</td>
<td>gnuplot’s traditional pm3d scheme
(black-blue-red-yellow)</td>
</tr>
<tr class="row-odd"><td>gnuplot2</td>
<td>sequential color printable as gray
(black-blue-violet-yellow-white)</td>
</tr>
<tr class="row-even"><td>ocean</td>
<td>green-blue-white</td>
</tr>
<tr class="row-odd"><td>rainbow</td>
<td>spectral purple-blue-green-yellow-orange-red colormap
with diverging luminance</td>
</tr>
<tr class="row-even"><td>seismic</td>
<td>diverging blue-white-red</td>
</tr>
<tr class="row-odd"><td>terrain</td>
<td>mapmaker’s colors, blue-green-yellow-brown-white,
originally from IGOR Pro</td>
</tr>
</tbody>
</table>
</div></blockquote>
<p>The following colormaps are redundant and may be removed in future
versions. It’s recommended to use <em>gray</em> or <em>gray_r</em> instead, which
produce identical output:</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="14%" />
<col width="86%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>gist_gray</td>
<td>identical to <em>gray</em></td>
</tr>
<tr class="row-odd"><td>gist_yarg</td>
<td>identical to <em>gray_r</em></td>
</tr>
<tr class="row-even"><td>binary</td>
<td>identical to <em>gray_r</em></td>
</tr>
</tbody>
</table>
</div></blockquote>
<p class="rubric">Footnotes</p>
<table class="docutils footnote" frame="void" id="id5" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>Rainbow colormaps, <tt class="docutils literal"><span class="pre">jet</span></tt> in particular, are considered a poor
choice for scientific visualization by many researchers: <a class="reference external" href="http://www.jwave.vt.edu/%7Erkriz/Projects/create_color_table/color_07.pdf">Rainbow Color
Map (Still) Considered Harmful</a></td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id6" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>Resembles “BkBlAqGrYeOrReViWh200” from NCAR Command
Language. See <a class="reference external" href="http://www.ncl.ucar.edu/Document/Graphics/color_table_gallery.shtml">Color Table Gallery</a></td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id7" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id3">[3]</a></td><td>See <a class="reference external" href="http://www.cs.unm.edu/~kmorel/documents/ColorMaps/">Diverging Color Maps for Scientific Visualization</a> by Kenneth
Moreland.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id8" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4">[4]</a></td><td>See <a class="reference external" href="http://www.mathworks.com/matlabcentral/fileexchange/2662-cmrmap-m">A Color Map for Effective Black-and-White Rendering of
Color-Scale Images</a>
by Carey Rappaport</td></tr>
</tbody>
</table>
</dd></dl>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="api_changes.html" title="API Changes"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="The Matplotlib API"
>previous</a> |</li>
<li><a href="../index.html">home</a>| </li>
<li><a href="../search.html">search</a>| </li>
<li><a href="../examples/index.html">examples</a>| </li>
<li><a href="../gallery.html">gallery</a>| </li>
<li><a href="../contents.html">docs</a> »</li>
<li><a href="index.html" >The Matplotlib API</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the matplotlib development team.
Last updated on Jul 23, 2013.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
