|
1 |
| -<!DOCTYPE HTML> |
2 |
| -<html lang="en"> |
3 |
| - <head> |
4 |
| - <meta charset="utf-8"> |
5 |
| - <meta http-equiv="refresh" content="0;url=stable/index.html" /> |
6 |
| - <link rel="canonical" href="https://matplotlib.org/stable/index.html" /> |
7 |
| - </head> |
8 |
| - <body> |
9 |
| - <h1> |
10 |
| - The page been moved <a href="stable/index.html">here</a>! |
11 |
| - </h1> |
12 |
| - </body> |
| 1 | + |
| 2 | +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| 3 | + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 4 | + |
| 5 | +<html xmlns="http://www.w3.org/1999/xhtml"> |
| 6 | + <head> |
| 7 | + <meta http-equiv="X-UA-Compatible" content="IE=Edge" /> |
| 8 | + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| 9 | + <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 10 | + <title>Matplotlib: Python plotting — Matplotlib 3.3.4 documentation</title> |
| 11 | + <link rel="stylesheet" href="_static/mpl.css?v3.3.4" type="text/css" /> |
| 12 | + <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> |
| 13 | + <link rel="stylesheet" type="text/css" href="_static/graphviz.css" /> |
| 14 | + <link rel="stylesheet" type="text/css" href="_static/copybutton.css" /> |
| 15 | + <link rel="stylesheet" type="text/css" href="_static/gallery.css" /> |
| 16 | + <link rel="stylesheet" type="text/css" href="_static/gallery-binder.css" /> |
| 17 | + <link rel="stylesheet" type="text/css" href="_static/gallery-dataframe.css" /> |
| 18 | + <link rel="stylesheet" type="text/css" href="_static/gallery-rendered-html.css" /> |
| 19 | + <script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> |
| 20 | + <script src="_static/jquery.js"></script> |
| 21 | + <script src="_static/underscore.js"></script> |
| 22 | + <script src="_static/doctools.js"></script> |
| 23 | + <script src="_static/language_data.js"></script> |
| 24 | + <script src="_static/clipboard.min.js"></script> |
| 25 | + <script src="_static/copybutton.js"></script> |
| 26 | + <script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script> |
| 27 | + <link rel="search" type="application/opensearchdescription+xml" |
| 28 | + title="Search within Matplotlib 3.3.4 documentation" |
| 29 | + href="_static/opensearch.xml"/> |
| 30 | + <link rel="shortcut icon" href="_static/favicon.ico"/> |
| 31 | + |
| 32 | + <link rel="index" title="Index" href="stable/genindex.html" /> |
| 33 | + <link rel="search" title="Search" href="stable/search.html" /> |
| 34 | + <link rel="top" title="Matplotlib 3.3.4 documentation" href="#" /> |
| 35 | + <link rel="canonical" href="https://matplotlib.org/stable/index.html" /> |
| 36 | + |
| 37 | + <link rel="stylesheet" href="_static/custom.css" type="text/css" /> |
| 38 | + |
| 39 | + |
| 40 | + <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" /> |
| 41 | + |
| 42 | + </head><body> |
| 43 | + |
| 44 | + |
| 45 | +<!-- |
| 46 | +<div id="annc-banner"> |
| 47 | +
|
| 48 | +</div> |
| 49 | +--> |
| 50 | + |
| 51 | +<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px; position: relative;"> |
| 52 | + <a href="stable/index.html"> |
| 53 | + <div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px"><span style="float: right; color: #789; background: white">Version 3.3.4</span></div> |
| 54 | + <img src="_static/logo2_compressed.svg" height="125px" border="0" alt="matplotlib"/></a> |
| 55 | + |
| 56 | + <!-- The "Fork me on github" ribbon --> |
| 57 | + <div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div> |
| 58 | + </div> |
| 59 | + |
| 60 | + <nav class="main-nav"> |
| 61 | + <ul> |
| 62 | + <li><a href="stable/users/installing.html">Installation</a></li> |
| 63 | + <li><a href="stable/contents.html">Documentation</a></li> |
| 64 | + <li><a href="stable/gallery/index.html">Examples</a></li> |
| 65 | + <li><a href="stable/tutorials/index.html">Tutorials</a></li> |
| 66 | + <li><a href="stable/devel/index.html">Contributing</a></li> |
| 67 | + <li class="nav-right"> |
| 68 | + <form class="search" action="search.html" method="get"> |
| 69 | + <input type="text" name="q" aria-labelledby="searchlabel" placeholder="Search"/> |
| 70 | + </form> |
| 71 | + </li> |
| 72 | + </ul> |
| 73 | + </nav> |
| 74 | + <div class="related" role="navigation" aria-label="related navigation"> |
| 75 | + <h3>Navigation</h3> |
| 76 | + <ul> |
| 77 | + <li class="right" style="margin-right: 10px"> |
| 78 | + <a href="stable/genindex.html" title="General Index" |
| 79 | + accesskey="I">index</a></li> |
| 80 | + <li class="right" > |
| 81 | + <a href="stable/py-modindex.html" title="Python Module Index" |
| 82 | + >modules</a> |</li> |
| 83 | + <li><a href="stable/index.html">home</a>| </li> |
| 84 | + <li><a href="stable/contents.html">contents</a> »</li> |
| 85 | + <li class="nav-item nav-item-this"><a href="stable/index.html">Matplotlib: Python plotting</a></li> |
| 86 | + </ul> |
| 87 | + </div> |
| 88 | + |
| 89 | + <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> |
| 90 | + <div class="sphinxsidebarwrapper"><div class="sidebar-versions"> |
| 91 | +<script> |
| 92 | +function getSnippet(id, url) { |
| 93 | + var req = false; |
| 94 | + // For Safari, Firefox, and other non-MS browsers |
| 95 | + if (window.XMLHttpRequest) { |
| 96 | + try { |
| 97 | + req = new XMLHttpRequest(); |
| 98 | + } catch (e) { |
| 99 | + req = false; |
| 100 | + } |
| 101 | + } else if (window.ActiveXObject) { |
| 102 | + // For Internet Explorer on Windows |
| 103 | + try { |
| 104 | + req = new ActiveXObject("Msxml2.XMLHTTP"); |
| 105 | + } catch (e) { |
| 106 | + try { |
| 107 | + req = new ActiveXObject("Microsoft.XMLHTTP"); |
| 108 | + } catch (e) { |
| 109 | + req = false; |
| 110 | + } |
| 111 | + } |
| 112 | + } |
| 113 | + var element = document.querySelector(".sidebar-versions"); |
| 114 | + if (req) { |
| 115 | + // Synchronous request, wait till we have it all |
| 116 | + req.open('GET', url, false); |
| 117 | + req.send(null); |
| 118 | + if (req.status == 200) { |
| 119 | + element.innerHTML = req.responseText; |
| 120 | + } else { |
| 121 | + element.innerHTML = "<mark>Could not find Snippet to insert at " + url + "</mark>" |
| 122 | + } |
| 123 | + } |
| 124 | +} |
| 125 | +getSnippet('other_versions', '/versions.html'); |
| 126 | +</script> |
| 127 | +</div> |
| 128 | + |
| 129 | + |
| 130 | +<div id="sidebar-donations"> |
| 131 | + <a href="https://numfocus.org/donate-to-matplotlib" target="_blank"> <div class="donate_button" >Support Matplotlib</div></a> |
| 132 | +</div> |
| 133 | + </div> |
| 134 | + </div> |
| 135 | + |
| 136 | + <div class="document"> |
| 137 | + <div class="documentwrapper"> |
| 138 | + <div class="bodywrapper"> |
| 139 | + |
| 140 | + |
| 141 | + <div class="body" role="main"> |
| 142 | + |
| 143 | + <div class="section" id="matplotlib-visualization-with-python"> |
| 144 | +<h1>Matplotlib: Visualization with Python<a class="headerlink" href="stable/#matplotlib-visualization-with-python" title="Permalink to this headline">¶</a></h1> |
| 145 | +<p>Matplotlib is a comprehensive library for creating static, animated, |
| 146 | +and interactive visualizations in Python.</p> |
| 147 | +<div class="responsive_screenshots"> |
| 148 | + <a href="stable/tutorials/introductory/sample_plots.html"> |
| 149 | + <div class="responsive_subfig"> |
| 150 | + <img align="middle" src="_images/sphx_glr_membrane_thumb.png" |
| 151 | + border="0" alt="screenshots"/> |
| 152 | + </div> |
| 153 | + <div class="responsive_subfig"> |
| 154 | + <img align="middle" src="_images/sphx_glr_histogram_thumb.png" |
| 155 | + border="0" alt="screenshots"/> |
| 156 | + </div> |
| 157 | + <div class="responsive_subfig"> |
| 158 | + <img align="middle" src="_images/sphx_glr_contour_thumb.png" |
| 159 | + border="0" alt="screenshots"/> |
| 160 | + </div> |
| 161 | + <div class="responsive_subfig"> |
| 162 | + <img align="middle" src="_images/sphx_glr_3D_thumb.png" |
| 163 | + border="0" alt="screenshots"/> |
| 164 | + </div> |
| 165 | + </a> |
| 166 | +</div> |
| 167 | +<span class="clear_screenshots"></span><p>Matplotlib makes easy things easy and hard things possible.</p> |
| 168 | +<div class="bullet-box-container docutils container"> |
| 169 | +<div class="bullet-box docutils container"> |
| 170 | +<p>Create</p> |
| 171 | +<ul class="simple"> |
| 172 | +<li>Develop <a class="reference external" href="stable/gallery/index.html">publication quality plots</a> with just a few lines of code</li> |
| 173 | +<li>Use <a class="reference external" href="stable/gallery/index.html#event-handling">interactive figures</a> that can zoom, pan, update...</li> |
| 174 | +</ul> |
| 175 | +</div> |
| 176 | +<div class="bullet-box docutils container"> |
| 177 | +<p>Customize</p> |
| 178 | +<ul class="simple"> |
| 179 | +<li><a class="reference external" href="stable/tutorials/index.html#tutorials">Take full control</a> of line styles, font properties, axes properties...</li> |
| 180 | +<li><a class="reference external" href="stable/api/index_backend_api.html">Export and embed</a> to a number of file formats and interactive environments</li> |
| 181 | +</ul> |
| 182 | +</div> |
| 183 | +<div class="bullet-box docutils container"> |
| 184 | +<p>Extend</p> |
| 185 | +<ul class="simple"> |
| 186 | +<li>Explore tailored functionality provided by |
| 187 | +<a class="reference internal" href="stable/thirdpartypackages/index.html"><span class="doc">third party packages</span></a></li> |
| 188 | +<li>Learn more about Matplotlib through the many |
| 189 | +<a class="reference internal" href="stable/resources/index.html"><span class="doc">external learning resources</span></a></li> |
| 190 | +</ul> |
| 191 | +</div> |
| 192 | +</div> |
| 193 | +<div class="section" id="documentation"> |
| 194 | +<h2>Documentation<a class="headerlink" href="stable/#documentation" title="Permalink to this headline">¶</a></h2> |
| 195 | +<p>To get started, read the |
| 196 | + <a class="reference internal" href="stable/users/index.html"><span class="doc">User's Guide</span></a>.</p> |
| 197 | +<p>Trying to learn how to do a particular kind of plot? Check out the |
| 198 | +<a class="reference internal" href="stable/gallery/index.html"><span class="doc">examples gallery</span></a> or the <a class="reference internal" href="stable/api/pyplot_summary.html"><span class="doc">list of plotting commands</span></a>.</p> |
| 199 | +</div> |
| 200 | +<div class="section" id="join-our-community"> |
| 201 | +<h2>Join our community!<a class="headerlink" href="stable/#join-our-community" title="Permalink to this headline">¶</a></h2> |
| 202 | +<p>Matplotlib is a welcoming, inclusive project, and we follow the <a class="reference external" href="https://www.python.org/psf/conduct/">Python |
| 203 | +Software Foundation Code of Conduct</a> in everything we do.</p> |
| 204 | +<h3>Get help</h3> |
| 205 | +<div class="box"> |
| 206 | + <div class="box-item"> |
| 207 | + <img src="_static/fa/discourse-brands.svg" alt="Discourse"> |
| 208 | + <p>Join our community at <a href="https://discourse.matplotlib.org">discourse.matplotlib.org</a> |
| 209 | + to get help, discuss contributing & development, and share your work.</p> |
| 210 | + </div> |
| 211 | + <div class="box-item"> |
| 212 | + <img src="_static/fa/question-circle-regular.svg" alt="Questions"> |
| 213 | + <p>If you have questions, be sure to check the <a href="stable/faq/index.html">FAQ</a>, |
| 214 | + the <a href="stable/api/index.html">API</a> docs. The full text |
| 215 | + <a href="stable/search.html">search</a> is a good way to discover the docs including the many examples.</p> |
| 216 | + </div> |
| 217 | + <div class="box-item"> |
| 218 | + <img src="_static/fa/stack-overflow-brands.svg" alt="Stackoverflow"> |
| 219 | + <p>Check out the Matplotlib tag on <a href="https://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.</p> |
| 220 | + </div> |
| 221 | + <div class="box-item"> |
| 222 | + <img src="_static/fa/gitter-brands.svg" alt="Gitter"> |
| 223 | + <p>Short questions may be posted on the <a href="https://gitter.im/matplotlib/matplotlib">gitter channel</a>.</p> |
| 224 | + </div> |
| 225 | +</div> |
| 226 | +<hr class='box-sep'> |
| 227 | +<h3>News</h3> |
| 228 | +<div class="box"> |
| 229 | + <div class="box-item"> |
| 230 | + <img src="_static/fa/plus-square-regular.svg" alt="News"> |
| 231 | + <p>To keep up to date with what's going on in Matplotlib, see the |
| 232 | + <a href="stable/users/whats_new.html">what's new</a> page or browse the |
| 233 | + <a href="https://github.com/matplotlib/matplotlib">source code</a>. Anything that could |
| 234 | + require changes to your existing code is logged in the |
| 235 | + <a href="stable/api/api_changes.html">API changes</a> file.</p> |
| 236 | + </div> |
| 237 | + <div class="box-item"> |
| 238 | + <img src="_static/fa/hashtag-solid.svg" alt="Social media"> |
| 239 | + <ul> |
| 240 | + <li>Tweet us at <a href="https://twitter.com/matplotlib">@matplotlib</a>!</li> |
| 241 | + <li>See cool plots on <a href="https://www.instagram.com/matplotart/">@matplotart</a> Instagram!</li> |
| 242 | + <li>Check out our <a href="https://matplotlib.org/matplotblog/">Blog</a>!</li> |
| 243 | + </ul> |
| 244 | + </div> |
| 245 | +</div> |
| 246 | +<hr class='box-sep'> |
| 247 | +<h3>Development</h3> |
| 248 | +<div class="box"> |
| 249 | + <div class="box-item"> |
| 250 | + <img src="_static/fa/github-brands.svg" alt="Github"> |
| 251 | + <p>Matplotlib is hosted on <a href="https://github.com/matplotlib/matplotlib">GitHub</a>.</p> |
| 252 | + <ul> |
| 253 | + <li>File bugs and feature requests on the <a href="https://github.com/matplotlib/matplotlib/issues">issue tracker</a>.</li> |
| 254 | + <li><a href="https://github.com/matplotlib/matplotlib/pulls">Pull requests</a> are always welcome.</li> |
| 255 | + </ul> |
| 256 | + <p>It is a good idea to ping us on <a href="https://discourse.matplotlib.org">Discourse</a> as well.</p> |
| 257 | + </div> |
| 258 | + <div class="box-item"> |
| 259 | + <img src="_static/fa/envelope-regular.svg" alt="Mailing lists"> |
| 260 | + <p>Mailing lists</p> |
| 261 | + <ul> |
| 262 | + <li><a href="https://mail.python.org/mailman/listinfo/matplotlib-users">matplotlib-users</a> for usage questions</li> |
| 263 | + <li><a href="https://mail.python.org/mailman/listinfo/matplotlib-devel">matplotlib-devel</a> for development</li> |
| 264 | + <li><a href="https://mail.python.org/mailman/listinfo/matplotlib-announce">matplotlib-announce</a> for project announcements</li> |
| 265 | + </ul> |
| 266 | + </div> |
| 267 | +</div><div class="section" id="toolkits"> |
| 268 | +<h3>Toolkits<a class="headerlink" href="stable/#toolkits" title="Permalink to this headline">¶</a></h3> |
| 269 | +<p>Matplotlib ships with several add-on <a class="reference internal" href="stable/api/toolkits/index.html"><span class="doc">toolkits</span></a>, |
| 270 | +including 3D plotting with <a class="reference internal" href="stable/api/toolkits/mplot3d.html#module-mpl_toolkits.mplot3d" title="mpl_toolkits.mplot3d"><code class="xref py py-obj docutils literal notranslate"><span class="pre">mplot3d</span></code></a>, axes helpers in <a class="reference internal" href="stable/api/toolkits/axes_grid1.html#module-mpl_toolkits.axes_grid1" title="mpl_toolkits.axes_grid1"><code class="xref py py-obj docutils literal notranslate"><span class="pre">axes_grid1</span></code></a> and axis |
| 271 | +helpers in <a class="reference internal" href="stable/api/toolkits/axisartist.html#module-mpl_toolkits.axisartist" title="mpl_toolkits.axisartist"><code class="xref py py-obj docutils literal notranslate"><span class="pre">axisartist</span></code></a>.</p> |
| 272 | +</div> |
| 273 | +<div class="section" id="third-party-packages"> |
| 274 | +<h3>Third party packages<a class="headerlink" href="stable/#third-party-packages" title="Permalink to this headline">¶</a></h3> |
| 275 | +<p>A large number of <a class="reference internal" href="stable/thirdpartypackages/index.html"><span class="doc">third party packages</span></a> |
| 276 | +extend and build on Matplotlib functionality, including several higher-level |
| 277 | +plotting interfaces (<a class="reference external" href="https://seaborn.pydata.org">seaborn</a>, <a class="reference external" href="https://holoviews.org">HoloViews</a>, <a class="reference external" href="http://ggplot.yhathq.com">ggplot</a>, ...), and a projection |
| 278 | +and mapping toolkit (<a class="reference external" href="https://scitools.org.uk/cartopy/docs/latest">Cartopy</a>).</p> |
| 279 | +</div> |
| 280 | +<div class="section" id="citing-matplotlib"> |
| 281 | +<h3>Citing Matplotlib<a class="headerlink" href="stable/#citing-matplotlib" title="Permalink to this headline">¶</a></h3> |
| 282 | +<p>Matplotlib is the brainchild of John Hunter (1968-2012), who, along with its |
| 283 | +many contributors, have put an immeasurable amount of time and effort into |
| 284 | +producing a piece of software utilized by thousands of scientists worldwide.</p> |
| 285 | +<p>If Matplotlib contributes to a project that leads to a scientific publication, |
| 286 | +please acknowledge this work by citing the project. A <a class="reference internal" href="stable/citing.html"><span class="doc">ready-made citation |
| 287 | +entry</span></a> is available.</p> |
| 288 | +</div> |
| 289 | +<div class="section" id="open-source"> |
| 290 | +<h3>Open source<a class="headerlink" href="stable/#open-source" title="Permalink to this headline">¶</a></h3> |
| 291 | +<a href="https://numfocus.org/"> |
| 292 | +<img src="_static/numfocus_badge.png" |
| 293 | + alt="A Fiscally Sponsored Project of NUMFocus" |
| 294 | + style="float:right; margin-left:20px" /> |
| 295 | +</a><p>Matplotlib is a Sponsored Project of NumFOCUS, a 501(c)(3) nonprofit |
| 296 | +charity in the United States. NumFOCUS provides Matplotlib with |
| 297 | +fiscal, legal, and administrative support to help ensure the health |
| 298 | +and sustainability of the project. Visit <a class="reference external" href="https://numfocus.org">numfocus.org</a> for more |
| 299 | +information.</p> |
| 300 | +<p>Donations to Matplotlib are managed by NumFOCUS. For donors in the |
| 301 | +United States, your gift is tax-deductible to the extent provided by |
| 302 | +law. As with any donation, you should consult with your tax adviser |
| 303 | +about your particular tax situation.</p> |
| 304 | +<p>Please consider <a class="reference external" href="https://numfocus.org/donate-to-matplotlib">donating to the Matplotlib project</a> through |
| 305 | +the NumFOCUS organization or to the <a class="reference external" href="https://numfocus.org/programs/john-hunter-technology-fellowship/">John Hunter Technology Fellowship</a>.</p> |
| 306 | +<p>The <a class="reference internal" href="stable/users/license.html"><span class="doc">Matplotlib license</span></a> is based on the <a class="reference external" href="https://www.python.org/psf/license">Python Software |
| 307 | +Foundation (PSF) license</a>.</p> |
| 308 | +<p>There is an active developer community and a long list of people who have made |
| 309 | +significant <a class="reference internal" href="stable/users/credits.html"><span class="doc">contributions</span></a>.</p> |
| 310 | +</div> |
| 311 | +</div> |
| 312 | +</div> |
| 313 | + |
| 314 | + |
| 315 | + </div> |
| 316 | + |
| 317 | + </div> |
| 318 | + </div> |
| 319 | + <div class="clearer"></div> |
| 320 | + </div> |
| 321 | +<footer> |
| 322 | + <div class="footer"> |
| 323 | + © Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2021 The Matplotlib development team. |
| 324 | +<br /> |
| 325 | + Last updated on Jan 28, 2021. |
| 326 | +Created using |
| 327 | +<a href="http://sphinx-doc.org/">Sphinx</a> 3.1.1. |
| 328 | +Doc version v3.3.4. |
| 329 | + </div> |
| 330 | +</footer> |
| 331 | +<script> |
| 332 | + (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ |
| 333 | + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), |
| 334 | + m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) |
| 335 | + })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); |
| 336 | + |
| 337 | + ga('create', 'UA-55954603-1', 'auto'); |
| 338 | + ga('send', 'pageview'); |
| 339 | + |
| 340 | +</script> |
| 341 | + </body> |
13 | 342 | </html>
|
0 commit comments