|
1 |
| -<!DOCTYPE HTML> |
2 |
| -<htmllang="en"> |
3 |
| -<head> |
4 |
| -<metacharset="utf-8"> |
5 |
| -<metahttp-equiv="refresh"content="0;url=stable/index.html"/> |
6 |
| -<linkrel="canonical"href="https://matplotlib.org/stable/index.html"/> |
7 |
| -</head> |
8 |
| -<body> |
9 |
| -<h1> |
10 |
| - The page been moved<ahref="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 | +<htmlxmlns="http://www.w3.org/1999/xhtml"> |
| 6 | +<head> |
| 7 | +<metahttp-equiv="X-UA-Compatible"content="IE=Edge"/> |
| 8 | +<metahttp-equiv="Content-Type"content="text/html; charset=utf-8"/> |
| 9 | +<metaname="viewport"content="width=device-width, initial-scale=1.0"> |
| 10 | +<title>Matplotlib: Python plotting — Matplotlib 3.3.4 documentation</title> |
| 11 | +<linkrel="stylesheet"href="_static/mpl.css?v3.3.4"type="text/css"/> |
| 12 | +<linkrel="stylesheet"href="_static/pygments.css"type="text/css"/> |
| 13 | +<linkrel="stylesheet"type="text/css"href="_static/graphviz.css"/> |
| 14 | +<linkrel="stylesheet"type="text/css"href="_static/copybutton.css"/> |
| 15 | +<linkrel="stylesheet"type="text/css"href="_static/gallery.css"/> |
| 16 | +<linkrel="stylesheet"type="text/css"href="_static/gallery-binder.css"/> |
| 17 | +<linkrel="stylesheet"type="text/css"href="_static/gallery-dataframe.css"/> |
| 18 | +<linkrel="stylesheet"type="text/css"href="_static/gallery-rendered-html.css"/> |
| 19 | +<scriptid="documentation_options"data-url_root="./"src="_static/documentation_options.js"></script> |
| 20 | +<scriptsrc="_static/jquery.js"></script> |
| 21 | +<scriptsrc="_static/underscore.js"></script> |
| 22 | +<scriptsrc="_static/doctools.js"></script> |
| 23 | +<scriptsrc="_static/language_data.js"></script> |
| 24 | +<scriptsrc="_static/clipboard.min.js"></script> |
| 25 | +<scriptsrc="_static/copybutton.js"></script> |
| 26 | +<scriptasync="async"src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"></script> |
| 27 | +<linkrel="search"type="application/opensearchdescription+xml" |
| 28 | +title="Search within Matplotlib 3.3.4 documentation" |
| 29 | +href="_static/opensearch.xml"/> |
| 30 | +<linkrel="shortcut icon"href="_static/favicon.ico"/> |
| 31 | + |
| 32 | +<linkrel="index"title="Index"href="stable/genindex.html"/> |
| 33 | +<linkrel="search"title="Search"href="stable/search.html"/> |
| 34 | +<linkrel="top"title="Matplotlib 3.3.4 documentation"href="#"/> |
| 35 | +<linkrel="canonical"href="https://matplotlib.org/stable/index.html"/> |
| 36 | + |
| 37 | +<linkrel="stylesheet"href="_static/custom.css"type="text/css"/> |
| 38 | + |
| 39 | + |
| 40 | +<metaname="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 | +<divstyle="background-color: white; text-align: left; padding: 10px 10px 15px 15px; position: relative;"> |
| 52 | +<ahref="stable/index.html"> |
| 53 | +<divstyle="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px"><spanstyle="float: right; color: #789; background: white">Version 3.3.4</span></div> |
| 54 | +<imgsrc="_static/logo2_compressed.svg"height="125px"border="0"alt="matplotlib"/></a> |
| 55 | + |
| 56 | +<!-- The "Fork me on github" ribbon --> |
| 57 | +<divid="forkongithub"><ahref="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div> |
| 58 | +</div> |
| 59 | + |
| 60 | +<navclass="main-nav"> |
| 61 | +<ul> |
| 62 | +<li><ahref="stable/users/installing.html">Installation</a></li> |
| 63 | +<li><ahref="stable/contents.html">Documentation</a></li> |
| 64 | +<li><ahref="stable/gallery/index.html">Examples</a></li> |
| 65 | +<li><ahref="stable/tutorials/index.html">Tutorials</a></li> |
| 66 | +<li><ahref="stable/devel/index.html">Contributing</a></li> |
| 67 | +<liclass="nav-right"> |
| 68 | +<formclass="search"action="stable/search.html"method="get"> |
| 69 | +<inputtype="text"name="q"aria-labelledby="searchlabel"placeholder="Search"/> |
| 70 | +</form> |
| 71 | +</li> |
| 72 | +</ul> |
| 73 | +</nav> |
| 74 | +<divclass="related"role="navigation"aria-label="related navigation"> |
| 75 | +<h3>Navigation</h3> |
| 76 | +<ul> |
| 77 | +<liclass="right"style="margin-right: 10px"> |
| 78 | +<ahref="stable/genindex.html"title="General Index" |
| 79 | +accesskey="I">index</a></li> |
| 80 | +<liclass="right"> |
| 81 | +<ahref="stable/py-modindex.html"title="Python Module Index" |
| 82 | +>modules</a> |</li> |
| 83 | +<li><ahref="stable/index.html">home</a>| </li> |
| 84 | +<li><ahref="stable/contents.html">contents</a> »</li> |
| 85 | +<liclass="nav-item nav-item-this"><ahref="stable/index.html">Matplotlib: Python plotting</a></li> |
| 86 | +</ul> |
| 87 | +</div> |
| 88 | + |
| 89 | +<divclass="sphinxsidebar"role="navigation"aria-label="main navigation"> |
| 90 | +<divclass="sphinxsidebarwrapper"><divclass="sidebar-versions"> |
| 91 | +<script> |
| 92 | +functiongetSnippet(id,url){ |
| 93 | +varreq=false; |
| 94 | +// For Safari, Firefox, and other non-MS browsers |
| 95 | +if(window.XMLHttpRequest){ |
| 96 | +try{ |
| 97 | +req=newXMLHttpRequest(); |
| 98 | +}catch(e){ |
| 99 | +req=false; |
| 100 | +} |
| 101 | +}elseif(window.ActiveXObject){ |
| 102 | +// For Internet Explorer on Windows |
| 103 | +try{ |
| 104 | +req=newActiveXObject("Msxml2.XMLHTTP"); |
| 105 | +}catch(e){ |
| 106 | +try{ |
| 107 | +req=newActiveXObject("Microsoft.XMLHTTP"); |
| 108 | +}catch(e){ |
| 109 | +req=false; |
| 110 | +} |
| 111 | +} |
| 112 | +} |
| 113 | +varelement=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 | +<divid="sidebar-donations"> |
| 131 | +<ahref="https://numfocus.org/donate-to-matplotlib"target="_blank"><divclass="donate_button">Support Matplotlib</div></a> |
| 132 | +</div> |
| 133 | +</div> |
| 134 | +</div> |
| 135 | + |
| 136 | +<divclass="document"> |
| 137 | +<divclass="documentwrapper"> |
| 138 | +<divclass="bodywrapper"> |
| 139 | + |
| 140 | + |
| 141 | +<divclass="body"role="main"> |
| 142 | + |
| 143 | +<divclass="section"id="matplotlib-visualization-with-python"> |
| 144 | +<h1>Matplotlib: Visualization with Python<aclass="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 | +<divclass="responsive_screenshots"> |
| 148 | +<ahref="stable/tutorials/introductory/sample_plots.html"> |
| 149 | +<divclass="responsive_subfig"> |
| 150 | +<imgalign="middle"src="_images/sphx_glr_membrane_thumb.png" |
| 151 | +border="0"alt="screenshots"/> |
| 152 | +</div> |
| 153 | +<divclass="responsive_subfig"> |
| 154 | +<imgalign="middle"src="_images/sphx_glr_histogram_thumb.png" |
| 155 | +border="0"alt="screenshots"/> |
| 156 | +</div> |
| 157 | +<divclass="responsive_subfig"> |
| 158 | +<imgalign="middle"src="_images/sphx_glr_contour_thumb.png" |
| 159 | +border="0"alt="screenshots"/> |
| 160 | +</div> |
| 161 | +<divclass="responsive_subfig"> |
| 162 | +<imgalign="middle"src="_images/sphx_glr_3D_thumb.png" |
| 163 | +border="0"alt="screenshots"/> |
| 164 | +</div> |
| 165 | +</a> |
| 166 | +</div> |
| 167 | +<spanclass="clear_screenshots"></span><p>Matplotlib makes easy things easy and hard things possible.</p> |
| 168 | +<divclass="bullet-box-container docutils container"> |
| 169 | +<divclass="bullet-box docutils container"> |
| 170 | +<p>Create</p> |
| 171 | +<ulclass="simple"> |
| 172 | +<li>Develop<aclass="reference external"href="stable/gallery/index.html">publication quality plots</a> with just a few lines of code</li> |
| 173 | +<li>Use<aclass="reference external"href="stable/gallery/index.html#event-handling">interactive figures</a> that can zoom, pan, update...</li> |
| 174 | +</ul> |
| 175 | +</div> |
| 176 | +<divclass="bullet-box docutils container"> |
| 177 | +<p>Customize</p> |
| 178 | +<ulclass="simple"> |
| 179 | +<li><aclass="reference external"href="stable/tutorials/index.html#tutorials">Take full control</a> of line styles, font properties, axes properties...</li> |
| 180 | +<li><aclass="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 | +<divclass="bullet-box docutils container"> |
| 184 | +<p>Extend</p> |
| 185 | +<ulclass="simple"> |
| 186 | +<li>Explore tailored functionality provided by |
| 187 | +<aclass="reference internal"href="stable/thirdpartypackages/index.html"><spanclass="doc">third party packages</span></a></li> |
| 188 | +<li>Learn more about Matplotlib through the many |
| 189 | +<aclass="reference internal"href="stable/resources/index.html"><spanclass="doc">external learning resources</span></a></li> |
| 190 | +</ul> |
| 191 | +</div> |
| 192 | +</div> |
| 193 | +<divclass="section"id="documentation"> |
| 194 | +<h2>Documentation<aclass="headerlink"href="stable/#documentation"title="Permalink to this headline">¶</a></h2> |
| 195 | +<p>To get started, read the |
| 196 | +<aclass="reference internal"href="stable/users/index.html"><spanclass="doc">User's Guide</span></a>.</p> |
| 197 | +<p>Trying to learn how to do a particular kind of plot? Check out the |
| 198 | +<aclass="reference internal"href="stable/gallery/index.html"><spanclass="doc">examples gallery</span></a> or the<aclass="reference internal"href="stable/api/pyplot_summary.html"><spanclass="doc">list of plotting commands</span></a>.</p> |
| 199 | +</div> |
| 200 | +<divclass="section"id="join-our-community"> |
| 201 | +<h2>Join our community!<aclass="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<aclass="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 | +<divclass="box"> |
| 206 | +<divclass="box-item"> |
| 207 | +<imgsrc="_static/fa/discourse-brands.svg"alt="Discourse"> |
| 208 | +<p>Join our community at<ahref="https://discourse.matplotlib.org">discourse.matplotlib.org</a> |
| 209 | + to get help, discuss contributing & development, and share your work.</p> |
| 210 | +</div> |
| 211 | +<divclass="box-item"> |
| 212 | +<imgsrc="_static/fa/question-circle-regular.svg"alt="Questions"> |
| 213 | +<p>If you have questions, be sure to check the<ahref="stable/faq/index.html">FAQ</a>, |
| 214 | + the<ahref="stable/api/index.html">API</a> docs. The full text |
| 215 | +<ahref="stable/search.html">search</a> is a good way to discover the docs including the many examples.</p> |
| 216 | +</div> |
| 217 | +<divclass="box-item"> |
| 218 | +<imgsrc="_static/fa/stack-overflow-brands.svg"alt="Stackoverflow"> |
| 219 | +<p>Check out the Matplotlib tag on<ahref="https://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.</p> |
| 220 | +</div> |
| 221 | +<divclass="box-item"> |
| 222 | +<imgsrc="_static/fa/gitter-brands.svg"alt="Gitter"> |
| 223 | +<p>Short questions may be posted on the<ahref="https://gitter.im/matplotlib/matplotlib">gitter channel</a>.</p> |
| 224 | +</div> |
| 225 | +</div> |
| 226 | +<hrclass='box-sep'> |
| 227 | +<h3>News</h3> |
| 228 | +<divclass="box"> |
| 229 | +<divclass="box-item"> |
| 230 | +<imgsrc="_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 | +<ahref="stable/users/whats_new.html">what's new</a> page or browse the |
| 233 | +<ahref="https://github.com/matplotlib/matplotlib">source code</a>. Anything that could |
| 234 | + require changes to your existing code is logged in the |
| 235 | +<ahref="stable/api/api_changes.html">API changes</a> file.</p> |
| 236 | +</div> |
| 237 | +<divclass="box-item"> |
| 238 | +<imgsrc="_static/fa/hashtag-solid.svg"alt="Social media"> |
| 239 | +<ul> |
| 240 | +<li>Tweet us at<ahref="https://twitter.com/matplotlib">@matplotlib</a>!</li> |
| 241 | +<li>See cool plots on<ahref="https://www.instagram.com/matplotart/">@matplotart</a> Instagram!</li> |
| 242 | +<li>Check out our<ahref="https://matplotlib.org/matplotblog/">Blog</a>!</li> |
| 243 | +</ul> |
| 244 | +</div> |
| 245 | +</div> |
| 246 | +<hrclass='box-sep'> |
| 247 | +<h3>Development</h3> |
| 248 | +<divclass="box"> |
| 249 | +<divclass="box-item"> |
| 250 | +<imgsrc="_static/fa/github-brands.svg"alt="Github"> |
| 251 | +<p>Matplotlib is hosted on<ahref="https://github.com/matplotlib/matplotlib">GitHub</a>.</p> |
| 252 | +<ul> |
| 253 | +<li>File bugs and feature requests on the<ahref="https://github.com/matplotlib/matplotlib/issues">issue tracker</a>.</li> |
| 254 | +<li><ahref="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<ahref="https://discourse.matplotlib.org">Discourse</a> as well.</p> |
| 257 | +</div> |
| 258 | +<divclass="box-item"> |
| 259 | +<imgsrc="_static/fa/envelope-regular.svg"alt="Mailing lists"> |
| 260 | +<p>Mailing lists</p> |
| 261 | +<ul> |
| 262 | +<li><ahref="https://mail.python.org/mailman/listinfo/matplotlib-users">matplotlib-users</a> for usage questions</li> |
| 263 | +<li><ahref="https://mail.python.org/mailman/listinfo/matplotlib-devel">matplotlib-devel</a> for development</li> |
| 264 | +<li><ahref="https://mail.python.org/mailman/listinfo/matplotlib-announce">matplotlib-announce</a> for project announcements</li> |
| 265 | +</ul> |
| 266 | +</div> |
| 267 | +</div><divclass="section"id="toolkits"> |
| 268 | +<h3>Toolkits<aclass="headerlink"href="stable/#toolkits"title="Permalink to this headline">¶</a></h3> |
| 269 | +<p>Matplotlib ships with several add-on<aclass="reference internal"href="stable/api/toolkits/index.html"><spanclass="doc">toolkits</span></a>, |
| 270 | +including 3D plotting with<aclass="reference internal"href="stable/api/toolkits/mplot3d.html#module-mpl_toolkits.mplot3d"title="mpl_toolkits.mplot3d"><codeclass="xref py py-obj docutils literal notranslate"><spanclass="pre">mplot3d</span></code></a>, axes helpers in<aclass="reference internal"href="stable/api/toolkits/axes_grid1.html#module-mpl_toolkits.axes_grid1"title="mpl_toolkits.axes_grid1"><codeclass="xref py py-obj docutils literal notranslate"><spanclass="pre">axes_grid1</span></code></a> and axis |
| 271 | +helpers in<aclass="reference internal"href="stable/api/toolkits/axisartist.html#module-mpl_toolkits.axisartist"title="mpl_toolkits.axisartist"><codeclass="xref py py-obj docutils literal notranslate"><spanclass="pre">axisartist</span></code></a>.</p> |
| 272 | +</div> |
| 273 | +<divclass="section"id="third-party-packages"> |
| 274 | +<h3>Third party packages<aclass="headerlink"href="stable/#third-party-packages"title="Permalink to this headline">¶</a></h3> |
| 275 | +<p>A large number of<aclass="reference internal"href="stable/thirdpartypackages/index.html"><spanclass="doc">third party packages</span></a> |
| 276 | +extend and build on Matplotlib functionality, including several higher-level |
| 277 | +plotting interfaces (<aclass="reference external"href="https://seaborn.pydata.org">seaborn</a>,<aclass="reference external"href="https://holoviews.org">HoloViews</a>,<aclass="reference external"href="http://ggplot.yhathq.com">ggplot</a>, ...), and a projection |
| 278 | +and mapping toolkit (<aclass="reference external"href="https://scitools.org.uk/cartopy/docs/latest">Cartopy</a>).</p> |
| 279 | +</div> |
| 280 | +<divclass="section"id="citing-matplotlib"> |
| 281 | +<h3>Citing Matplotlib<aclass="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<aclass="reference internal"href="stable/citing.html"><spanclass="doc">ready-made citation |
| 287 | +entry</span></a> is available.</p> |
| 288 | +</div> |
| 289 | +<divclass="section"id="open-source"> |
| 290 | +<h3>Open source<aclass="headerlink"href="stable/#open-source"title="Permalink to this headline">¶</a></h3> |
| 291 | +<ahref="https://numfocus.org/"> |
| 292 | +<imgsrc="_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<aclass="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<aclass="reference external"href="https://numfocus.org/donate-to-matplotlib">donating to the Matplotlib project</a> through |
| 305 | +the NumFOCUS organization or to the<aclass="reference external"href="https://numfocus.org/programs/john-hunter-technology-fellowship/">John Hunter Technology Fellowship</a>.</p> |
| 306 | +<p>The<aclass="reference internal"href="stable/users/license.html"><spanclass="doc">Matplotlib license</span></a> is based on the<aclass="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<aclass="reference internal"href="stable/users/credits.html"><spanclass="doc">contributions</span></a>.</p> |
| 310 | +</div> |
| 311 | +</div> |
| 312 | +</div> |
| 313 | + |
| 314 | + |
| 315 | +</div> |
| 316 | + |
| 317 | +</div> |
| 318 | +</div> |
| 319 | +<divclass="clearer"></div> |
| 320 | +</div> |
| 321 | +<footer> |
| 322 | +<divclass="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 | +<ahref="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*newDate();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>
|