iframe-proxy | Sunbelt Computer Software

999 lines (971 loc) · 60.9 KB
<!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">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Plotting commands summary &mdash; Matplotlib 1.5.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.5.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.5.0 documentation"
          href="../_static/opensearch.xml"/>
    <link rel="top" title="Matplotlib 1.5.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" /> 
<link href="https://fonts.googleapis.com/css?family=Raleway" rel="stylesheet" type="text/css">
    <link rel="canonical" href="https://matplotlib.org/stable/api/pyplot_summary.html" />
    <script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>
<div id="unreleased-message"> You are reading an old version of the documentation (v1.5.0).  For the latest version see <a href="https://matplotlib.org/stable/api/pyplot_summary.html">https://matplotlib.org/stable/api/pyplot_summary.html</a></div>
    <div class="alert" style="background-color: #FEA46C; padding: 10px 0;
<h3>We're updating the default styles for Matplotlib 2.0</h3>
<p>Learn what to expect in the <a href="/style_changes.html" style="font-weight: bold;
color: #11557C;">new updates</a></p>
<link rel="shortcut icon" href="/_static/favicon.ico">
<!-- 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" />
<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 class="related">
      <h3>Navigation</h3>
        <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>|&nbsp;</li>
        <li><a href="../examples/index.html">examples</a>|&nbsp;</li>
        <li><a href="../gallery.html">gallery</a>|&nbsp;</li>
        <li><a href="#">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 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>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="../_sources/api/pyplot_summary.txt"
            rel="nofollow">Show Source</a></li>
<div id="searchbox" style="display: none" role="search">
  <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.
<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">
<code class="descclassname">matplotlib.pyplot.</code><code class="descname">plotting</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.pyplot.plotting" title="Permalink to this definition">¶</a></dt>
<dd><table border="1" class="docutils">
<col width="18%" />
<col width="82%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Function</th>
<th class="head">Description</th>
<tbody valign="top">
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.acorr" title="matplotlib.pyplot.acorr"><code class="xref py py-obj docutils literal"><span class="pre">acorr</span></code></a></td>
<td>Plot the autocorrelation of <code class="xref py py-obj docutils literal"><span class="pre">x</span></code>.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.angle_spectrum" title="matplotlib.pyplot.angle_spectrum"><code class="xref py py-obj docutils literal"><span class="pre">angle_spectrum</span></code></a></td>
<td>Plot the angle spectrum.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.annotate" title="matplotlib.pyplot.annotate"><code class="xref py py-obj docutils literal"><span class="pre">annotate</span></code></a></td>
<td>Create an annotation: a piece of text referring to a data point.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.arrow" title="matplotlib.pyplot.arrow"><code class="xref py py-obj docutils literal"><span class="pre">arrow</span></code></a></td>
<td>Add an arrow to the axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.autoscale" title="matplotlib.pyplot.autoscale"><code class="xref py py-obj docutils literal"><span class="pre">autoscale</span></code></a></td>
<td>Autoscale the axis view to the data (toggle).</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axes" title="matplotlib.pyplot.axes"><code class="xref py py-obj docutils literal"><span class="pre">axes</span></code></a></td>
<td>Add an axes to the figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axhline" title="matplotlib.pyplot.axhline"><code class="xref py py-obj docutils literal"><span class="pre">axhline</span></code></a></td>
<td>Add a horizontal line across the axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axhspan" title="matplotlib.pyplot.axhspan"><code class="xref py py-obj docutils literal"><span class="pre">axhspan</span></code></a></td>
<td>Add a horizontal span (rectangle) across the axis.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axis" title="matplotlib.pyplot.axis"><code class="xref py py-obj docutils literal"><span class="pre">axis</span></code></a></td>
<td>Convenience method to get or set axis properties.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axvline" title="matplotlib.pyplot.axvline"><code class="xref py py-obj docutils literal"><span class="pre">axvline</span></code></a></td>
<td>Add a vertical line across the axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.axvspan" title="matplotlib.pyplot.axvspan"><code class="xref py py-obj docutils literal"><span class="pre">axvspan</span></code></a></td>
<td>Add a vertical span (rectangle) across the axes.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.bar" title="matplotlib.pyplot.bar"><code class="xref py py-obj docutils literal"><span class="pre">bar</span></code></a></td>
<td>Make a bar plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.barbs" title="matplotlib.pyplot.barbs"><code class="xref py py-obj docutils literal"><span class="pre">barbs</span></code></a></td>
<td>Plot a 2-D field of barbs.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.barh" title="matplotlib.pyplot.barh"><code class="xref py py-obj docutils literal"><span class="pre">barh</span></code></a></td>
<td>Make a horizontal bar plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.box" title="matplotlib.pyplot.box"><code class="xref py py-obj docutils literal"><span class="pre">box</span></code></a></td>
<td>Turn the axes box on or off.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.boxplot" title="matplotlib.pyplot.boxplot"><code class="xref py py-obj docutils literal"><span class="pre">boxplot</span></code></a></td>
<td>Make a box and whisker plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.broken_barh" title="matplotlib.pyplot.broken_barh"><code class="xref py py-obj docutils literal"><span class="pre">broken_barh</span></code></a></td>
<td>Plot horizontal bars.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.cla" title="matplotlib.pyplot.cla"><code class="xref py py-obj docutils literal"><span class="pre">cla</span></code></a></td>
<td>Clear the current axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.clabel" title="matplotlib.pyplot.clabel"><code class="xref py py-obj docutils literal"><span class="pre">clabel</span></code></a></td>
<td>Label a contour plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.clf" title="matplotlib.pyplot.clf"><code class="xref py py-obj docutils literal"><span class="pre">clf</span></code></a></td>
<td>Clear the current figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.clim" title="matplotlib.pyplot.clim"><code class="xref py py-obj docutils literal"><span class="pre">clim</span></code></a></td>
<td>Set the color limits of the current image.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.close" title="matplotlib.pyplot.close"><code class="xref py py-obj docutils literal"><span class="pre">close</span></code></a></td>
<td>Close a figure window.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.cohere" title="matplotlib.pyplot.cohere"><code class="xref py py-obj docutils literal"><span class="pre">cohere</span></code></a></td>
<td>Plot the coherence between <em>x</em> and <em>y</em>.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.colorbar" title="matplotlib.pyplot.colorbar"><code class="xref py py-obj docutils literal"><span class="pre">colorbar</span></code></a></td>
<td>Add a colorbar to a plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.contour" title="matplotlib.pyplot.contour"><code class="xref py py-obj docutils literal"><span class="pre">contour</span></code></a></td>
<td>Plot contours.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.contourf" title="matplotlib.pyplot.contourf"><code class="xref py py-obj docutils literal"><span class="pre">contourf</span></code></a></td>
<td>Plot contours.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.csd" title="matplotlib.pyplot.csd"><code class="xref py py-obj docutils literal"><span class="pre">csd</span></code></a></td>
<td>Plot the cross-spectral density.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.delaxes" title="matplotlib.pyplot.delaxes"><code class="xref py py-obj docutils literal"><span class="pre">delaxes</span></code></a></td>
<td>Remove an axes from the current figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.draw" title="matplotlib.pyplot.draw"><code class="xref py py-obj docutils literal"><span class="pre">draw</span></code></a></td>
<td>Redraw the current figure.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.errorbar" title="matplotlib.pyplot.errorbar"><code class="xref py py-obj docutils literal"><span class="pre">errorbar</span></code></a></td>
<td>Plot an errorbar graph.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.eventplot" title="matplotlib.pyplot.eventplot"><code class="xref py py-obj docutils literal"><span class="pre">eventplot</span></code></a></td>
<td>Plot identical parallel lines at specific positions.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figimage" title="matplotlib.pyplot.figimage"><code class="xref py py-obj docutils literal"><span class="pre">figimage</span></code></a></td>
<td>Adds a non-resampled image to the figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figlegend" title="matplotlib.pyplot.figlegend"><code class="xref py py-obj docutils literal"><span class="pre">figlegend</span></code></a></td>
<td>Place a legend in the figure.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fignum_exists" title="matplotlib.pyplot.fignum_exists"><code class="xref py py-obj docutils literal"><span class="pre">fignum_exists</span></code></a></td>
<td>&nbsp;</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figtext" title="matplotlib.pyplot.figtext"><code class="xref py py-obj docutils literal"><span class="pre">figtext</span></code></a></td>
<td>Add text to figure.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.figure" title="matplotlib.pyplot.figure"><code class="xref py py-obj docutils literal"><span class="pre">figure</span></code></a></td>
<td>Creates a new figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fill" title="matplotlib.pyplot.fill"><code class="xref py py-obj docutils literal"><span class="pre">fill</span></code></a></td>
<td>Plot filled polygons.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fill_between" title="matplotlib.pyplot.fill_between"><code class="xref py py-obj docutils literal"><span class="pre">fill_between</span></code></a></td>
<td>Make filled polygons between two curves.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.fill_betweenx" title="matplotlib.pyplot.fill_betweenx"><code class="xref py py-obj docutils literal"><span class="pre">fill_betweenx</span></code></a></td>
<td>Make filled polygons between two horizontal curves.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.findobj" title="matplotlib.pyplot.findobj"><code class="xref py py-obj docutils literal"><span class="pre">findobj</span></code></a></td>
<td>Find artist objects.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.gca" title="matplotlib.pyplot.gca"><code class="xref py py-obj docutils literal"><span class="pre">gca</span></code></a></td>
<td>Get the current <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">Axes</span></code></a> instance on the     current figure matching the given keyword args, or create one.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.gcf" title="matplotlib.pyplot.gcf"><code class="xref py py-obj docutils literal"><span class="pre">gcf</span></code></a></td>
<td>Get a reference to the current figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.gci" title="matplotlib.pyplot.gci"><code class="xref py py-obj docutils literal"><span class="pre">gci</span></code></a></td>
<td>Get the current colorable artist.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.get_figlabels" title="matplotlib.pyplot.get_figlabels"><code class="xref py py-obj docutils literal"><span class="pre">get_figlabels</span></code></a></td>
<td>Return a list of existing figure labels.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.get_fignums" title="matplotlib.pyplot.get_fignums"><code class="xref py py-obj docutils literal"><span class="pre">get_fignums</span></code></a></td>
<td>Return a list of existing figure numbers.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.grid" title="matplotlib.pyplot.grid"><code class="xref py py-obj docutils literal"><span class="pre">grid</span></code></a></td>
<td>Turn the axes grids on or off.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hexbin" title="matplotlib.pyplot.hexbin"><code class="xref py py-obj docutils literal"><span class="pre">hexbin</span></code></a></td>
<td>Make a hexagonal binning plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hist" title="matplotlib.pyplot.hist"><code class="xref py py-obj docutils literal"><span class="pre">hist</span></code></a></td>
<td>Plot a histogram.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hist2d" title="matplotlib.pyplot.hist2d"><code class="xref py py-obj docutils literal"><span class="pre">hist2d</span></code></a></td>
<td>Make a 2D histogram plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hlines" title="matplotlib.pyplot.hlines"><code class="xref py py-obj docutils literal"><span class="pre">hlines</span></code></a></td>
<td>Plot horizontal lines at each <code class="xref py py-obj docutils literal"><span class="pre">y</span></code> from <code class="xref py py-obj docutils literal"><span class="pre">xmin</span></code> to <code class="xref py py-obj docutils literal"><span class="pre">xmax</span></code>.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.hold" title="matplotlib.pyplot.hold"><code class="xref py py-obj docutils literal"><span class="pre">hold</span></code></a></td>
<td>Set the hold state.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.imread" title="matplotlib.pyplot.imread"><code class="xref py py-obj docutils literal"><span class="pre">imread</span></code></a></td>
<td>Read an image from a file into an array.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.imsave" title="matplotlib.pyplot.imsave"><code class="xref py py-obj docutils literal"><span class="pre">imsave</span></code></a></td>
<td>Save an array as in image file.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.imshow" title="matplotlib.pyplot.imshow"><code class="xref py py-obj docutils literal"><span class="pre">imshow</span></code></a></td>
<td>Display an image on the axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.install_repl_displayhook" title="matplotlib.pyplot.install_repl_displayhook"><code class="xref py py-obj docutils literal"><span class="pre">install_repl_displayhook</span></code></a></td>
<td>Install a repl display hook so that any stale figure are automatically     redrawn when control is returned to the repl.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ioff" title="matplotlib.pyplot.ioff"><code class="xref py py-obj docutils literal"><span class="pre">ioff</span></code></a></td>
<td>Turn interactive mode off.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ion" title="matplotlib.pyplot.ion"><code class="xref py py-obj docutils literal"><span class="pre">ion</span></code></a></td>
<td>Turn interactive mode on.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ishold" title="matplotlib.pyplot.ishold"><code class="xref py py-obj docutils literal"><span class="pre">ishold</span></code></a></td>
<td>Return the hold status of the current axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.isinteractive" title="matplotlib.pyplot.isinteractive"><code class="xref py py-obj docutils literal"><span class="pre">isinteractive</span></code></a></td>
<td>Return status of interactive mode.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.legend" title="matplotlib.pyplot.legend"><code class="xref py py-obj docutils literal"><span class="pre">legend</span></code></a></td>
<td>Places a legend on the axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.locator_params" title="matplotlib.pyplot.locator_params"><code class="xref py py-obj docutils literal"><span class="pre">locator_params</span></code></a></td>
<td>Control behavior of tick locators.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.loglog" title="matplotlib.pyplot.loglog"><code class="xref py py-obj docutils literal"><span class="pre">loglog</span></code></a></td>
<td>Make a plot with log scaling on both the <em>x</em> and <em>y</em> axis.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.magnitude_spectrum" title="matplotlib.pyplot.magnitude_spectrum"><code class="xref py py-obj docutils literal"><span class="pre">magnitude_spectrum</span></code></a></td>
<td>Plot the magnitude spectrum.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.margins" title="matplotlib.pyplot.margins"><code class="xref py py-obj docutils literal"><span class="pre">margins</span></code></a></td>
<td>Set or retrieve autoscaling margins.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.matshow" title="matplotlib.pyplot.matshow"><code class="xref py py-obj docutils literal"><span class="pre">matshow</span></code></a></td>
<td>Display an array as a matrix in a new figure window.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.minorticks_off" title="matplotlib.pyplot.minorticks_off"><code class="xref py py-obj docutils literal"><span class="pre">minorticks_off</span></code></a></td>
<td>Remove minor ticks from the current plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.minorticks_on" title="matplotlib.pyplot.minorticks_on"><code class="xref py py-obj docutils literal"><span class="pre">minorticks_on</span></code></a></td>
<td>Display minor ticks on the current plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.over" title="matplotlib.pyplot.over"><code class="xref py py-obj docutils literal"><span class="pre">over</span></code></a></td>
<td>Call a function with hold(True).</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pause" title="matplotlib.pyplot.pause"><code class="xref py py-obj docutils literal"><span class="pre">pause</span></code></a></td>
<td>Pause for <em>interval</em> seconds.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pcolor" title="matplotlib.pyplot.pcolor"><code class="xref py py-obj docutils literal"><span class="pre">pcolor</span></code></a></td>
<td>Create a pseudocolor plot of a 2-D array.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pcolormesh" title="matplotlib.pyplot.pcolormesh"><code class="xref py py-obj docutils literal"><span class="pre">pcolormesh</span></code></a></td>
<td>Plot a quadrilateral mesh.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.phase_spectrum" title="matplotlib.pyplot.phase_spectrum"><code class="xref py py-obj docutils literal"><span class="pre">phase_spectrum</span></code></a></td>
<td>Plot the phase spectrum.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.pie" title="matplotlib.pyplot.pie"><code class="xref py py-obj docutils literal"><span class="pre">pie</span></code></a></td>
<td>Plot a pie chart.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.plot" title="matplotlib.pyplot.plot"><code class="xref py py-obj docutils literal"><span class="pre">plot</span></code></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"><code class="xref py py-class docutils literal"><span class="pre">Axes</span></code></a>.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.plot_date" title="matplotlib.pyplot.plot_date"><code class="xref py py-obj docutils literal"><span class="pre">plot_date</span></code></a></td>
<td>Plot with data with dates.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.plotfile" title="matplotlib.pyplot.plotfile"><code class="xref py py-obj docutils literal"><span class="pre">plotfile</span></code></a></td>
<td>Plot the data in in a file.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.polar" title="matplotlib.pyplot.polar"><code class="xref py py-obj docutils literal"><span class="pre">polar</span></code></a></td>
<td>Make a polar plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.psd" title="matplotlib.pyplot.psd"><code class="xref py py-obj docutils literal"><span class="pre">psd</span></code></a></td>
<td>Plot the power spectral density.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.quiver" title="matplotlib.pyplot.quiver"><code class="xref py py-obj docutils literal"><span class="pre">quiver</span></code></a></td>
<td>Plot a 2-D field of arrows.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.quiverkey" title="matplotlib.pyplot.quiverkey"><code class="xref py py-obj docutils literal"><span class="pre">quiverkey</span></code></a></td>
<td>Add a key to a quiver plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rc" title="matplotlib.pyplot.rc"><code class="xref py py-obj docutils literal"><span class="pre">rc</span></code></a></td>
<td>Set the current rc params.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rc_context" title="matplotlib.pyplot.rc_context"><code class="xref py py-obj docutils literal"><span class="pre">rc_context</span></code></a></td>
<td>Return a context manager for managing rc settings.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rcdefaults" title="matplotlib.pyplot.rcdefaults"><code class="xref py py-obj docutils literal"><span class="pre">rcdefaults</span></code></a></td>
<td>Restore the default rc params.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.rgrids" title="matplotlib.pyplot.rgrids"><code class="xref py py-obj docutils literal"><span class="pre">rgrids</span></code></a></td>
<td>Get or set the radial gridlines on a polar plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.savefig" title="matplotlib.pyplot.savefig"><code class="xref py py-obj docutils literal"><span class="pre">savefig</span></code></a></td>
<td>Save the current figure.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.sca" title="matplotlib.pyplot.sca"><code class="xref py py-obj docutils literal"><span class="pre">sca</span></code></a></td>
<td>Set the current Axes instance to <em>ax</em>.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.scatter" title="matplotlib.pyplot.scatter"><code class="xref py py-obj docutils literal"><span class="pre">scatter</span></code></a></td>
<td>Make a scatter plot of x vs y, where x and y are sequence like objects of the same lengths.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.sci" title="matplotlib.pyplot.sci"><code class="xref py py-obj docutils literal"><span class="pre">sci</span></code></a></td>
<td>Set the current image.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.semilogx" title="matplotlib.pyplot.semilogx"><code class="xref py py-obj docutils literal"><span class="pre">semilogx</span></code></a></td>
<td>Make a plot with log scaling on the <em>x</em> axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.semilogy" title="matplotlib.pyplot.semilogy"><code class="xref py py-obj docutils literal"><span class="pre">semilogy</span></code></a></td>
<td>Make a plot with log scaling on the <em>y</em> axis.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.set_cmap" title="matplotlib.pyplot.set_cmap"><code class="xref py py-obj docutils literal"><span class="pre">set_cmap</span></code></a></td>
<td>Set the default colormap.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.setp" title="matplotlib.pyplot.setp"><code class="xref py py-obj docutils literal"><span class="pre">setp</span></code></a></td>
<td>Set a property on an artist object.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.show" title="matplotlib.pyplot.show"><code class="xref py py-obj docutils literal"><span class="pre">show</span></code></a></td>
<td>Display a figure.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.specgram" title="matplotlib.pyplot.specgram"><code class="xref py py-obj docutils literal"><span class="pre">specgram</span></code></a></td>
<td>Plot a spectrogram.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.spy" title="matplotlib.pyplot.spy"><code class="xref py py-obj docutils literal"><span class="pre">spy</span></code></a></td>
<td>Plot the sparsity pattern on a 2-D array.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.stackplot" title="matplotlib.pyplot.stackplot"><code class="xref py py-obj docutils literal"><span class="pre">stackplot</span></code></a></td>
<td>Draws a stacked area plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.stem" title="matplotlib.pyplot.stem"><code class="xref py py-obj docutils literal"><span class="pre">stem</span></code></a></td>
<td>Create a stem plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.step" title="matplotlib.pyplot.step"><code class="xref py py-obj docutils literal"><span class="pre">step</span></code></a></td>
<td>Make a step plot.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.streamplot" title="matplotlib.pyplot.streamplot"><code class="xref py py-obj docutils literal"><span class="pre">streamplot</span></code></a></td>
<td>Draws streamlines of a vector flow.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplot" title="matplotlib.pyplot.subplot"><code class="xref py py-obj docutils literal"><span class="pre">subplot</span></code></a></td>
<td>Return a subplot axes positioned by the given grid definition.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplot2grid" title="matplotlib.pyplot.subplot2grid"><code class="xref py py-obj docutils literal"><span class="pre">subplot2grid</span></code></a></td>
<td>Create a subplot in a grid.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplot_tool" title="matplotlib.pyplot.subplot_tool"><code class="xref py py-obj docutils literal"><span class="pre">subplot_tool</span></code></a></td>
<td>Launch a subplot tool window for a figure.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplots" title="matplotlib.pyplot.subplots"><code class="xref py py-obj docutils literal"><span class="pre">subplots</span></code></a></td>
<td>Create a figure with a set of subplots already made.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.subplots_adjust" title="matplotlib.pyplot.subplots_adjust"><code class="xref py py-obj docutils literal"><span class="pre">subplots_adjust</span></code></a></td>
<td>Tune the subplot layout.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.suptitle" title="matplotlib.pyplot.suptitle"><code class="xref py py-obj docutils literal"><span class="pre">suptitle</span></code></a></td>
<td>Add a centered title to the figure.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.switch_backend" title="matplotlib.pyplot.switch_backend"><code class="xref py py-obj docutils literal"><span class="pre">switch_backend</span></code></a></td>
<td>Switch the default backend.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.table" title="matplotlib.pyplot.table"><code class="xref py py-obj docutils literal"><span class="pre">table</span></code></a></td>
<td>Add a table to the current axes.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.text" title="matplotlib.pyplot.text"><code class="xref py py-obj docutils literal"><span class="pre">text</span></code></a></td>
<td>Add text to the axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.thetagrids" title="matplotlib.pyplot.thetagrids"><code class="xref py py-obj docutils literal"><span class="pre">thetagrids</span></code></a></td>
<td>Get or set the theta locations of the gridlines in a polar plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tick_params" title="matplotlib.pyplot.tick_params"><code class="xref py py-obj docutils literal"><span class="pre">tick_params</span></code></a></td>
<td>Change the appearance of ticks and tick labels.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ticklabel_format" title="matplotlib.pyplot.ticklabel_format"><code class="xref py py-obj docutils literal"><span class="pre">ticklabel_format</span></code></a></td>
<td>Change the <a class="reference internal" href="ticker_api.html#matplotlib.ticker.ScalarFormatter" title="matplotlib.ticker.ScalarFormatter"><code class="xref py py-obj docutils literal"><span class="pre">ScalarFormatter</span></code></a> used by default for linear axes.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tight_layout" title="matplotlib.pyplot.tight_layout"><code class="xref py py-obj docutils literal"><span class="pre">tight_layout</span></code></a></td>
<td>Automatically adjust subplot parameters to give specified padding.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.title" title="matplotlib.pyplot.title"><code class="xref py py-obj docutils literal"><span class="pre">title</span></code></a></td>
<td>Set a title of the current axes.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tricontour" title="matplotlib.pyplot.tricontour"><code class="xref py py-obj docutils literal"><span class="pre">tricontour</span></code></a></td>
<td>Draw contours on an unstructured triangular grid.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tricontourf" title="matplotlib.pyplot.tricontourf"><code class="xref py py-obj docutils literal"><span class="pre">tricontourf</span></code></a></td>
<td>Draw contours on an unstructured triangular grid.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.tripcolor" title="matplotlib.pyplot.tripcolor"><code class="xref py py-obj docutils literal"><span class="pre">tripcolor</span></code></a></td>
<td>Create a pseudocolor plot of an unstructured triangular grid.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.triplot" title="matplotlib.pyplot.triplot"><code class="xref py py-obj docutils literal"><span class="pre">triplot</span></code></a></td>
<td>Draw a unstructured triangular grid as lines and/or markers.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.twinx" title="matplotlib.pyplot.twinx"><code class="xref py py-obj docutils literal"><span class="pre">twinx</span></code></a></td>
<td>Make a second axes that shares the <em>x</em>-axis.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.twiny" title="matplotlib.pyplot.twiny"><code class="xref py py-obj docutils literal"><span class="pre">twiny</span></code></a></td>
<td>Make a second axes that shares the <em>y</em>-axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.uninstall_repl_displayhook" title="matplotlib.pyplot.uninstall_repl_displayhook"><code class="xref py py-obj docutils literal"><span class="pre">uninstall_repl_displayhook</span></code></a></td>
<td>Uninstalls the matplotlib display hook.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.violinplot" title="matplotlib.pyplot.violinplot"><code class="xref py py-obj docutils literal"><span class="pre">violinplot</span></code></a></td>
<td>Make a violin plot.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.vlines" title="matplotlib.pyplot.vlines"><code class="xref py py-obj docutils literal"><span class="pre">vlines</span></code></a></td>
<td>Plot vertical lines.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xcorr" title="matplotlib.pyplot.xcorr"><code class="xref py py-obj docutils literal"><span class="pre">xcorr</span></code></a></td>
<td>Plot the cross correlation between <em>x</em> and <em>y</em>.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xkcd" title="matplotlib.pyplot.xkcd"><code class="xref py py-obj docutils literal"><span class="pre">xkcd</span></code></a></td>
<td>Turns on <a class="reference external" href="http://xkcd.com/">xkcd</a> sketch-style drawing mode.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xlabel" title="matplotlib.pyplot.xlabel"><code class="xref py py-obj docutils literal"><span class="pre">xlabel</span></code></a></td>
<td>Set the <em>x</em> axis label of the current axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xlim" title="matplotlib.pyplot.xlim"><code class="xref py py-obj docutils literal"><span class="pre">xlim</span></code></a></td>
<td>Get or set the <em>x</em> limits of the current axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xscale" title="matplotlib.pyplot.xscale"><code class="xref py py-obj docutils literal"><span class="pre">xscale</span></code></a></td>
<td>Set the scaling of the <em>x</em>-axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.xticks" title="matplotlib.pyplot.xticks"><code class="xref py py-obj docutils literal"><span class="pre">xticks</span></code></a></td>
<td>Get or set the <em>x</em>-limits of the current tick locations and labels.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ylabel" title="matplotlib.pyplot.ylabel"><code class="xref py py-obj docutils literal"><span class="pre">ylabel</span></code></a></td>
<td>Set the <em>y</em> axis label of the current axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.ylim" title="matplotlib.pyplot.ylim"><code class="xref py py-obj docutils literal"><span class="pre">ylim</span></code></a></td>
<td>Get or set the <em>y</em>-limits of the current axes.</td>
<tr class="row-even"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.yscale" title="matplotlib.pyplot.yscale"><code class="xref py py-obj docutils literal"><span class="pre">yscale</span></code></a></td>
<td>Set the scaling of the <em>y</em>-axis.</td>
<tr class="row-odd"><td><a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.yticks" title="matplotlib.pyplot.yticks"><code class="xref py py-obj docutils literal"><span class="pre">yticks</span></code></a></td>
<td>Get or set the <em>y</em>-limits of the current tick locations and labels.</td>
<dl class="function">
<dt id="matplotlib.pyplot.colormaps">
<code class="descclassname">matplotlib.pyplot.</code><code class="descname">colormaps</code><span class="sig-paren">(</span><span class="sig-paren">)</span><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
<a class="reference internal" href="cm_api.html#matplotlib.cm.register_cmap" title="matplotlib.cm.register_cmap"><code class="xref py py-func docutils literal"><span class="pre">register_cmap()</span></code></a>.  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>
<p>or using the <a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.set_cmap" title="matplotlib.pyplot.set_cmap"><code class="xref py py-func docutils literal"><span class="pre">set_cmap()</span></code></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">&#39;hot&#39;</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">&#39;jet&#39;</span><span class="p">)</span>
</pre></div>
<p>In interactive mode, <a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.set_cmap" title="matplotlib.pyplot.set_cmap"><code class="xref py py-func docutils literal"><span class="pre">set_cmap()</span></code></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 <code class="docutils literal"><span class="pre">_r</span></code>: For instance,
<code class="docutils literal"><span class="pre">gray_r</span></code> is the reverse of <code class="docutils literal"><span class="pre">gray</span></code>.</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>
<p>The base colormaps are derived from those of the same name provided
with Matlab:</p>
<blockquote>
<div><table border="1" class="docutils">
<col width="13%" />
<col width="87%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
<tbody valign="top">
<tr class="row-even"><td>autumn</td>
<td>sequential linearly-increasing shades of red-orange-yellow</td>
<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 class="row-even"><td>cool</td>
<td>linearly-decreasing shades of cyan-magenta</td>
<tr class="row-odd"><td>copper</td>
<td>sequential increasing shades of black-copper</td>
<tr class="row-even"><td>flag</td>
<td>repetitive red-white-blue-black pattern (not cyclic at
endpoints)</td>
<tr class="row-odd"><td>gray</td>
<td>sequential linearly-increasing black-to-white
grayscale</td>
<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 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 class="row-even"><td>inferno</td>
<td>perceptually uniform shades of black-red-yellow</td>
<tr class="row-odd"><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="#id6" id="id1">[1]</a></td>
<tr class="row-even"><td>magma</td>
<td>perceptually uniform shades of black-red-white</td>
<tr class="row-odd"><td>pink</td>
<td>sequential increasing pastel black-pink-white, meant
for sepia tone colorization of photographs</td>
<tr class="row-even"><td>plasma</td>
<td>perceptually uniform shades of blue-red-yellow</td>
<tr class="row-odd"><td>prism</td>
<td>repetitive red-yellow-green-blue-purple-...-green pattern
(not cyclic at endpoints)</td>
<tr class="row-even"><td>spring</td>
<td>linearly-increasing shades of magenta-yellow</td>
<tr class="row-odd"><td>summer</td>
<td>sequential linearly-increasing shades of green-yellow</td>
<tr class="row-even"><td>viridis</td>
<td>perceptually uniform shades of blue-green-yellow</td>
<tr class="row-odd"><td>winter</td>
<td>linearly-increasing shades of blue-green</td>
</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>
<p>The next set of palettes are from the <a class="reference external" href="http://dhmunro.github.io/yorick-doc/">Yorick scientific visualisation
package</a>, an evolution of
the GIST package, both by David H. Munro:</p>
<blockquote>
<div><table border="1" class="docutils">
<col width="18%" />
<col width="82%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
<tbody valign="top">
<tr class="row-even"><td>gist_earth</td>
<td>mapmaker&#8217;s colors from dark blue deep ocean to green
lowlands to brown highlands to white mountains</td>
<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 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="#id7" id="id2">[2]</a></td>
<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 class="row-even"><td>gist_stern</td>
<td>&#8220;Stern special&#8221; color table from Interactive Data
Language software</td>
</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">
<col width="19%" />
<col width="81%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
<tbody valign="top">
<tr class="row-even"><td>BrBG</td>
<td>brown, white, blue-green</td>
<tr class="row-odd"><td>PiYG</td>
<td>pink, white, yellow-green</td>
<tr class="row-even"><td>PRGn</td>
<td>purple, white, green</td>
<tr class="row-odd"><td>PuOr</td>
<td>orange, white, purple</td>
<tr class="row-even"><td>RdBu</td>
<td>red, white, blue</td>
<tr class="row-odd"><td>RdGy</td>
<td>red, white, gray</td>
<tr class="row-even"><td>RdYlBu</td>
<td>red, yellow, blue</td>
<tr class="row-odd"><td>RdYlGn</td>
<td>red, yellow, green</td>
<tr class="row-even"><td>Spectral</td>
<td>red, orange, yellow, green, blue</td>
</div></blockquote>
<p>ColorBrewer Sequential (luminance decreases monotonically):</p>
<blockquote>
<div><table border="1" class="docutils">
<col width="18%" />
<col width="82%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
<tbody valign="top">
<tr class="row-even"><td>Blues</td>
<td>white to dark blue</td>
<tr class="row-odd"><td>BuGn</td>
<td>white, light blue, dark green</td>
<tr class="row-even"><td>BuPu</td>
<td>white, light blue, dark purple</td>
<tr class="row-odd"><td>GnBu</td>
<td>white, light green, dark blue</td>
<tr class="row-even"><td>Greens</td>
<td>white to dark green</td>
<tr class="row-odd"><td>Greys</td>
<td>white to black (not linear)</td>
<tr class="row-even"><td>Oranges</td>
<td>white, orange, dark brown</td>
<tr class="row-odd"><td>OrRd</td>
<td>white, orange, dark red</td>
<tr class="row-even"><td>PuBu</td>
<td>white, light purple, dark blue</td>
<tr class="row-odd"><td>PuBuGn</td>
<td>white, light purple, dark green</td>
<tr class="row-even"><td>PuRd</td>
<td>white, light purple, dark red</td>
<tr class="row-odd"><td>Purples</td>
<td>white to dark purple</td>
<tr class="row-even"><td>RdPu</td>
<td>white, pink, dark purple</td>
<tr class="row-odd"><td>Reds</td>
<td>white to dark red</td>
<tr class="row-even"><td>YlGn</td>
<td>light yellow, dark green</td>
<tr class="row-odd"><td>YlGnBu</td>
<td>light yellow, light green, dark blue</td>
<tr class="row-even"><td>YlOrBr</td>
<td>light yellow, orange, dark brown</td>
<tr class="row-odd"><td>YlOrRd</td>
<td>light yellow, orange, dark red</td>
</div></blockquote>
<p>ColorBrewer Qualitative:</p>
<p>(For plotting nominal data, <code class="xref py py-class docutils literal"><span class="pre">ListedColormap</span></code> should be used,
not <code class="xref py py-class docutils literal"><span class="pre">LinearSegmentedColormap</span></code>.  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>
<p>Other miscellaneous schemes:</p>
<blockquote>
<div><table border="1" class="docutils">
<col width="19%" />
<col width="81%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
<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 class="row-odd"><td>brg</td>
<td>blue-red-green</td>
<tr class="row-even"><td>bwr</td>
<td>diverging blue-white-red</td>
<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="#id8" id="id3">[3]</a></td>
<tr class="row-even"><td>CMRmap</td>
<td>&#8220;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.&#8221; <a class="footnote-reference" href="#id9" id="id4">[4]</a></td>
<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 class="row-even"><td>gnuplot</td>
<td>gnuplot&#8217;s traditional pm3d scheme
(black-blue-red-yellow)</td>
<tr class="row-odd"><td>gnuplot2</td>
<td>sequential color printable as gray
(black-blue-violet-yellow-white)</td>
<tr class="row-even"><td>ocean</td>
<td>green-blue-white</td>
<tr class="row-odd"><td>rainbow</td>
<td>spectral purple-blue-green-yellow-orange-red colormap
with diverging luminance</td>
<tr class="row-even"><td>seismic</td>
<td>diverging blue-white-red</td>
<tr class="row-odd"><td>nipy_spectral</td>
<td>black-purple-blue-green-yellow-red-white spectrum,
originally from the Neuroimaging in Python project</td>
<tr class="row-even"><td>terrain</td>
<td>mapmaker&#8217;s colors, blue-green-yellow-brown-white,
originally from IGOR Pro</td>
</div></blockquote>
<p>The following colormaps are redundant and may be removed in future
versions.  It&#8217;s recommended to use the names in the descriptions
instead, which produce identical output:</p>
<blockquote>
<div><table border="1" class="docutils">
<col width="14%" />
<col width="86%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Colormap</th>
<th class="head">Description</th>
<tbody valign="top">
<tr class="row-even"><td>gist_gray</td>
<td>identical to <em>gray</em></td>
<tr class="row-odd"><td>gist_yarg</td>
<td>identical to <em>gray_r</em></td>
<tr class="row-even"><td>binary</td>
<td>identical to <em>gray_r</em></td>
<tr class="row-odd"><td>spectral</td>
<td>identical to <em>nipy_spectral</em> <a class="footnote-reference" href="#id10" id="id5">[5]</a></td>
</div></blockquote>
<p class="rubric">Footnotes</p>
<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="#id1">[1]</a></td><td>Rainbow colormaps, <code class="docutils literal"><span class="pre">jet</span></code> 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>
<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="#id2">[2]</a></td><td>Resembles &#8220;BkBlAqGrYeOrReViWh200&#8221; 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>
<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="#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>
<table class="docutils footnote" frame="void" id="id9" 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>
<table class="docutils footnote" frame="void" id="id10" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id5">[5]</a></td><td>Changed to distinguish from ColorBrewer&#8217;s <em>Spectral</em> map.
<a class="reference internal" href="pyplot_api.html#matplotlib.pyplot.spectral" title="matplotlib.pyplot.spectral"><code class="xref py py-func docutils literal"><span class="pre">spectral()</span></code></a> still works, but
<code class="docutils literal"><span class="pre">set_cmap('nipy_spectral')</span></code> is recommended for clarity.</td></tr>
          </div>
        </div>
      </div>
      <div class="clearer"></div>
    <div class="footer">
        &copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the matplotlib development team; 2012 - 2014 The matplotlib development team.
      Last updated on Oct 29, 2015.
      Created using <a
href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

pyplot_summary.html

Latest commit

History

pyplot_summary.html

File metadata and controls
