1 2<!DOCTYPE html> 3 4 5<html lang="en" data-content_root="../" > 6 7 <head> 8 <meta charset="utf-8" /> 9 <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> 10 11 <title>Using Matplotlib — Matplotlib 3.11.2 documentation</title> 12 13 14 15
15<script data-cfasync="false"> 16 document.documentElement.dataset.mode = localStorage.getItem("mode") || ""; 17 document.documentElement.dataset.theme = localStorage.getItem("theme") || ""; 18 </script>
18 19 <!-- 20 this give us a css class that will be invisible only if js is disabled 21 --> 22 <noscript> 23 <style> 24 .pst-js-only { display: none !important; } 25 26 </style> 27 </noscript> 28 29 <!-- Loaded before other Sphinx assets --> 30 <link href="../_static/styles/theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" /> 31<link href="../_static/styles/pydata-sphinx-theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" /> 32 33 <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=03e43079" /> 34 <link rel="stylesheet" type="text/css" href="../_static/css/style.css?v=522e7f4d" /> 35 <link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=4ae1632d" /> 36 <link rel="stylesheet" type="text/css" href="../_static/plot_directive.css" /> 37 <link rel="stylesheet" type="text/css" href="../_static/copybutton.css?v=76b2166b" /> 38 <link rel="stylesheet" type="text/css" href="../_static/sg_gallery.css?v=fd6457a4" /> 39 <link rel="stylesheet" type="text/css" href="../_static/sg_gallery-binder.css?v=f4aeca0c" /> 40 <link rel="stylesheet" type="text/css" href="../_static/sg_gallery-dataframe.css?v=2082cf3c" /> 41 <link rel="stylesheet" type="text/css" href="../_static/sg_gallery-rendered-html.css?v=1277b6f3" /> 42 <link rel="stylesheet" type="text/css" href="../_static/sphinx-design.min.css?v=95c83b7e" /> 43 <link rel="stylesheet" type="text/css" href="../_static/mpl.css?v=5a7e13c8" /> 44 45 <!-- So that users can add custom icons --> 46
46<script src="../_static/scripts/fontawesome.js?digest=8878045cc6db502f8baf" type="6241aca2045e30e90785789a-text/javascript"></script>
46 47 <!-- Pre-loaded scripts that we'll load fully later --> 48 <link rel="preload" as="script" href="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf" /> 49<link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf" /> 50 51
51<script src="../_static/documentation_options.js?v=1a85da86" type="6241aca2045e30e90785789a-text/javascript"></script>
51 52
52<script src="../_static/doctools.js?v=fd6eb6e6" type="6241aca2045e30e90785789a-text/javascript"></script>
52 53
53<script src="../_static/sphinx_highlight.js?v=6ffebe34" type="6241aca2045e30e90785789a-text/javascript"></script>
53 54
54<script src="../_static/sg-tags.js?v=d80f6fa4" type="6241aca2045e30e90785789a-text/javascript"></script>
54 55
55<script src="../_static/clipboard.min.js?v=a7894cd8" type="6241aca2045e30e90785789a-text/javascript"></script>
55 56
56<script src="../_static/copybutton.js?v=ccdb6887" type="6241aca2045e30e90785789a-text/javascript"></script>
56 57
57<script src="../_static/design-tabs.js?v=f930bc37" type="6241aca2045e30e90785789a-text/javascript"></script>
57 58
58<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js" type="6241aca2045e30e90785789a-text/javascript"></script>
58 59
59<script type="6241aca2045e30e90785789a-text/javascript">DOCUMENTATION_OPTIONS.pagename = 'users/index';</script>
59 60
60<script type="6241aca2045e30e90785789a-text/javascript"> 61 DOCUMENTATION_OPTIONS.theme_version = '0.16.1'; 62 DOCUMENTATION_OPTIONS.theme_switcher_json_url = 'https://matplotlib.org/devdocs/_static/switcher.json?v3.11.2-1-g879ad8ebba'; 63 DOCUMENTATION_OPTIONS.theme_switcher_version_match = '3.11.2'; 64 DOCUMENTATION_OPTIONS.show_version_warning_banner = 65 true; 66 </script>
66 67 <link rel="canonical" href="https://matplotlib.org/stable/users/index.html" /> 68 <link rel="search" type="application/opensearchdescription+xml" 69 title="Search within Matplotlib 3.11.2 documentation" 70 href="../_static/opensearch.xml"/> 71 <link rel="icon" href="../_static/favicon.ico"/> 72 <link rel="search" title="Search" href="../search.html" /> 73 <link rel="next" title="Frequently Asked Questions" href="faq.html" /> 74 <link rel="prev" title="Quick start guide" href="explain/quick_start.html" /> 75 <meta name="viewport" content="width=device-width, initial-scale=1"/> 76 <meta name="docsearch:language" content="en"/> 77 <meta name="docsearch:version" content="3.11.2" /> 78 <meta name="docbuild:last-update" content="Sep 11, 2026"/> 79 </head> 80 81 82 <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode=""> 83 84 85 86 <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div> 87 88 <div id="pst-scroll-pixel-helper"></div> 89 90 <button type="button" class="btn rounded-pill" id="pst-back-to-top"> 91 <i class="fa-solid fa-arrow-up"></i>Back to top</button> 92 93 94 <dialog id="pst-search-dialog"> 95 96<form class="bd-search d-flex align-items-center" 97 action="../search.html" 98 method="get"> 99 <i class="fa-solid fa-magnifying-glass"></i> 100 <input type="search" 101 class="form-control" 102 name="q" 103 placeholder="Search the docs ..." 104 aria-label="Search the docs ..." 105 autocomplete="off" 106 autocorrect="off" 107 autocapitalize="off" 108 spellcheck="false"/> 109 <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span> 110</form> 111 </dialog> 112 113 <div class="pst-async-banner-revealer d-none"> 114 <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside> 115</div> 116 117 118 <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none"> 119<div class="bd-header__inner bd-page-width"> 120 <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation"> 121 <span class="fa-solid fa-bars"></span> 122 </button> 123 124 125 <div class="col-lg-3 navbar-header-items__start"> 126 127 <div class="navbar-item"> 128 129 130 131 132 133<a class="navbar-brand logo" href="https://matplotlib.org/stable/"> 134 135 136 137 138 139 140 141 142 143 144 <img src="../_static/logo_light.svg" class="logo__image only-light" alt="Matplotlib 3.11.2 documentation - Home"/> 145 <img src="../_static/logo_dark.svg" class="logo__image only-dark pst-js-only" alt="Matplotlib 3.11.2 documentation - Home"/> 146 147 148</a></div> 149 150 </div> 151 152 <div class="col-lg-9 navbar-header-items"> 153 154 <div class="me-auto navbar-header-items__center"> 155 156 <div class="navbar-item"><ul id="navbar-main-elements" class="navbar-nav"> 157 <li class="nav-item"> 158 <a class="reference internal nav-link" href="../plot_types/index.html">Plot types</a> 159 </li> 160 <li class="nav-item"> 161 <a class="reference internal nav-link" href="#">User guide</a> 162 </li> 163 <li class="nav-item"> 164 <a class="reference internal nav-link" href="../tutorials/index.html">Tutorials</a> 165 </li> 166 <li class="nav-item"> 167 <a class="reference internal nav-link" href="../gallery/index.html">Examples</a> 168 </li> 169 <li class="nav-item"> 170 <a class="reference internal nav-link" href="../api/index.html">Reference</a> 171 </li> 172 <li class="nav-item"> 173 <a class="reference internal nav-link" href="../devel/index.html">Contribute</a> 174 </li> 175 <li class="nav-item"> 176 <a class="reference internal nav-link" href="release_notes.html">Releases</a> 177 </li> 178</ul></div> 179 180 </div> 181 182 183 <div class="navbar-header-items__end"> 184 185 <div class="navbar-item navbar-persistent--container"> 186 187 188<button class="btn btn-sm pst-navbar-icon search-button search-button__button pst-js-only" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip"> 189 <i class="fa-solid fa-magnifying-glass fa-lg"></i> 190</button> 191 </div> 192 193 194 <div class="navbar-item"> 195 196<button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button pst-js-only" aria-label="Color mode" data-bs-title="Color mode" data-bs-placement="bottom" data-bs-toggle="tooltip"> 197 <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light" title="Light"></i> 198 <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark" title="Dark"></i> 199 <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto" title="System Settings"></i> 200</button></div> 201 202 <div class="navbar-item"> 203<div class="version-switcher__container dropdown pst-js-only"> 204 <button id="pst-version-switcher-button-2" 205 type="button" 206 class="version-switcher__button btn btn-sm dropdown-toggle" 207 data-bs-toggle="dropdown" 208 aria-haspopup="listbox"
209 aria-controls="pst-version-switcher-list-2" 210 aria-label="Version switcher list" 211 > 212 Choose version <!-- this text may get changed later by javascript --> 213 <span class="caret"></span> 214 </button> 215 <div id="pst-version-switcher-list-2" 216 class="version-switcher__menu dropdown-menu list-group-flush py-0" 217 role="listbox" aria-labelledby="pst-version-switcher-button-2"> 218 <!-- dropdown will be populated by javascript on page load --> 219 </div> 220</div></div> 221 222 <div class="navbar-item"><ul class="navbar-icon-links" 223 aria-label="Icon Links"> 224 <li class="nav-item"> 225 226 227 228 229 230 231 232 233 <a href="https://gitter.im/matplotlib/matplotlib" title="Gitter" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-gitter fa-lg" aria-hidden="true"></i> 234 <span class="sr-only">Gitter</span></a> 235 </li> 236 <li class="nav-item"> 237 238 239 240 241 242 243 244 245 <a href="https://discourse.matplotlib.org" title="Discourse" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-discourse fa-lg" aria-hidden="true"></i> 246 <span class="sr-only">Discourse</span></a> 247 </li> 248 <li class="nav-item"> 249 250 251 252 253 254 255 256 257 <a href="https://github.com/matplotlib/matplotlib" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-github fa-lg" aria-hidden="true"></i> 258 <span class="sr-only">GitHub</span></a> 259 </li> 260</ul></div> 261 262 </div> 263 264 </div> 265 266 267 <div class="navbar-persistent--mobile"> 268 269<button class="btn btn-sm pst-navbar-icon search-button search-button__button pst-js-only" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip"> 270 <i class="fa-solid fa-magnifying-glass fa-lg"></i> 271</button> 272 </div> 273 274 275 276</div> 277 278 </header> 279 280 281 <div class="bd-container"> 282 <div class="bd-container__inner bd-page-width"> 283 284 285 286 <dialog id="pst-primary-sidebar-modal"></dialog> 287 <div id="pst-primary-sidebar" class="bd-sidebar-primary bd-sidebar"> 288 289 290 291 <div class="sidebar-header-items sidebar-primary__section"> 292 293 294 <div class="sidebar-header-items__center"> 295 296 297 298 <div class="navbar-item"><ul id="navbar-main-elements" class="navbar-nav"> 299 <li class="nav-item"> 300 <a class="reference internal nav-link" href="../plot_types/index.html">Plot types</a> 301 </li> 302 <li class="nav-item"> 303 <a class="reference internal nav-link" href="#">User guide</a> 304 </li> 305 <li class="nav-item"> 306 <a class="reference internal nav-link" href="../tutorials/index.html">Tutorials</a> 307 </li> 308 <li class="nav-item"> 309 <a class="reference internal nav-link" href="../gallery/index.html">Examples</a> 310 </li> 311 <li class="nav-item"> 312 <a class="reference internal nav-link" href="../api/index.html">Reference</a> 313 </li> 314 <li class="nav-item"> 315 <a class="reference internal nav-link" href="../devel/index.html">Contribute</a> 316 </li> 317 <li class="nav-item"> 318 <a class="reference internal nav-link" href="release_notes.html">Releases</a> 319 </li> 320</ul></div> 321 322 323 </div> 324 325 326 327 <div class="sidebar-header-items__end"> 328 329 <div class="navbar-item"> 330 331<button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button pst-js-only" aria-label="Color mode" data-bs-title="Color mode" data-bs-placement="bottom" data-bs-toggle="tooltip"> 332 <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light" title="Light"></i> 333 <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark" title="Dark"></i> 334 <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto" title="System Settings"></i> 335</button></div> 336 337 <div class="navbar-item"> 338<div class="version-switcher__container dropdown pst-js-only"> 339 <button id="pst-version-switcher-button-3" 340 type="button" 341 class="version-switcher__button btn btn-sm dropdown-toggle" 342 data-bs-toggle="dropdown" 343 aria-haspopup="listbox"
344 aria-controls="pst-version-switcher-list-3" 345 aria-label="Version switcher list" 346 > 347 Choose version <!-- this text may get changed later by javascript --> 348 <span class="caret"></span> 349 </button> 350 <div id="pst-version-switcher-list-3" 351 class="version-switcher__menu dropdown-menu list-group-flush py-0" 352 role="listbox" aria-labelledby="pst-version-switcher-button-3"> 353 <!-- dropdown will be populated by javascript on page load --> 354 </div> 355</div></div> 356 357 <div class="navbar-item"><ul class="navbar-icon-links" 358 aria-label="Icon Links"> 359 <li class="nav-item"> 360 361 362 363 364 365 366 367 368 <a href="https://gitter.im/matplotlib/matplotlib" title="Gitter" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-gitter fa-lg" aria-hidden="true"></i> 369 <span class="sr-only">Gitter</span></a> 370 </li> 371 <li class="nav-item"> 372 373 374 375 376 377 378 379 380 <a href="https://discourse.matplotlib.org" title="Discourse" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-discourse fa-lg" aria-hidden="true"></i> 381 <span class="sr-only">Discourse</span></a> 382 </li> 383 <li class="nav-item"> 384 385 386 387 388 389 390 391 392 <a href="https://github.com/matplotlib/matplotlib" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-github fa-lg" aria-hidden="true"></i> 393 <span class="sr-only">GitHub</span></a> 394 </li> 395</ul></div> 396 397 </div> 398 399 </div> 400 401 <div class="sidebar-primary-items__start sidebar-primary__section"> 402 <div class="sidebar-primary-item"> 403<nav class="bd-docs-nav bd-links" 404 aria-label="Section Navigation"> 405 <p class="bd-links__title" role="heading" aria-level="1">Section Navigation</p> 406 <div class="bd-toc-item navbar-nav"><ul class="nav bd-sidenav"> 407<li class="toctree-l1"><a class="reference internal" href="explain/quick_start.html">Quick start guide</a></li> 408</ul> 409<ul class="nav bd-sidenav"> 410<li class="toctree-l1"><a class="reference internal" href="faq.html">Frequently Asked Questions</a></li> 411</ul> 412<ul class="nav bd-sidenav"> 413<li class="toctree-l1 has-children"><a class="reference internal" href="explain/figure/index.html">Figures and backends</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 414<li class="toctree-l2"><a class="reference internal" href="explain/figure/figure_intro.html">Introduction to figures</a></li> 415<li class="toctree-l2"><a class="reference internal" href="explain/figure/backends.html">Output backends</a></li> 416<li class="toctree-l2"><a class="reference internal" href="explain/figure/api_interfaces.html">Matplotlib Application Interfaces (APIs)</a></li> 417<li class="toctree-l2"><a class="reference internal" href="explain/figure/interactive.html">Interacting with figures</a></li> 418<li class="toctree-l2"><a class="reference internal" href="explain/figure/interactive_guide.html">Interactive figures and asynchronous programming</a></li> 419<li class="toctree-l2"><a class="reference internal" href="explain/figure/event_handling.html">Event handling</a></li> 420<li class="toctree-l2"><a class="reference internal" href="explain/figure/writing_a_backend_pyplot_interface.html">Writing a backend -- the pyplot interface</a></li> 421</ul> 422</details></li> 423</ul> 424<ul class="nav bd-sidenav"> 425<li class="toctree-l1 has-children"><a class="reference internal" href="explain/axes/index.html">Axes and subplots</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 426<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_intro.html">Introduction to Axes (or Subplots)</a></li> 427<li class="toctree-l2"><a class="reference internal" href="explain/axes/arranging_axes.html">Arranging multiple Axes in a Figure</a></li> 428<li class="toctree-l2"><a class="reference internal" href="explain/axes/colorbar_placement.html">Placing colorbars</a></li> 429<li class="toctree-l2"><a class="reference internal" href="explain/axes/autoscale.html">Axis autoscaling</a></li> 430<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_scales.html">Axis scales</a></li> 431<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_ticks.html">Axis ticks</a></li> 432<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_units.html">Plotting dates and strings</a></li> 433<li class="toctree-l2"><a class="reference internal" href="explain/axes/legend_guide.html">Legends</a></li> 434<li class="toctree-l2"><a class="reference internal" href="explain/axes/mosaic.html">Subplot mosaic</a></li> 435<li class="toctree-l2"><a class="reference internal" href="explain/axes/constrainedlayout_guide.html">Constrained layout guide</a></li> 436<li class="toctree-l2"><a class="reference internal" href="explain/axes/tight_layout_guide.html">Tight layout guide (mildly discouraged)</a></li> 437</ul> 438</details></li> 439</ul> 440<ul class="nav bd-sidenav"> 441<li class="toctree-l1 has-children"><a class="reference internal" href="explain/artists/index.html">Artists</a>
441<details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 442<li class="toctree-l2"><a class="reference internal" href="explain/artists/artist_intro.html">Introduction to Artists</a></li> 443<li class="toctree-l2"><a class="reference internal" href="explain/artists/color_cycle.html">Automated color cycle</a></li> 444<li class="toctree-l2"><a class="reference internal" href="explain/artists/performance.html">Optimizing Artists for performance</a></li> 445<li class="toctree-l2"><a class="reference internal" href="explain/artists/paths.html">Paths</a></li> 446<li class="toctree-l2"><a class="reference internal" href="explain/artists/patheffects_guide.html">Path effects guide</a></li> 447<li class="toctree-l2"><a class="reference internal" href="explain/artists/imshow_extent.html">Understanding the extent keyword argument of imshow</a></li> 448<li class="toctree-l2"><a class="reference internal" href="explain/artists/transforms_tutorial.html">Transformations Tutorial</a></li> 449</ul> 450</details></li> 451</ul> 452<ul class="nav bd-sidenav"> 453<li class="toctree-l1"><a class="reference internal" href="explain/configuration.html">Matplotlib configuration - rcParams</a></li> 454</ul> 455<ul class="nav bd-sidenav"> 456<li class="toctree-l1"><a class="reference internal" href="explain/customizing.html">Customizing Matplotlib with style sheets and rcParams</a></li> 457</ul> 458<ul class="nav bd-sidenav"> 459<li class="toctree-l1 has-children"><a class="reference internal" href="explain/colors/index.html">Colors</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 460<li class="toctree-l2"><a class="reference internal" href="explain/colors/colorbar_only.html">Customized Colorbars Tutorial</a></li> 461<li class="toctree-l2"><a class="reference internal" href="explain/colors/colormap-manipulation.html">Creating Colormaps in Matplotlib</a></li> 462<li class="toctree-l2"><a class="reference internal" href="explain/colors/colormapnorms.html">Colormap normalization</a></li> 463<li class="toctree-l2"><a class="reference internal" href="explain/colors/colormaps.html">Choosing Colormaps in Matplotlib</a></li> 464<li class="toctree-l2"><a class="reference internal" href="explain/colors/colors.html">Specifying colors</a></li> 465</ul> 466</details></li> 467</ul> 468<ul class="nav bd-sidenav"> 469<li class="toctree-l1 has-children"><a class="reference internal" href="explain/text/index.html">Text</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 470<li class="toctree-l2"><a class="reference internal" href="explain/text/annotations.html">Annotations</a></li> 471<li class="toctree-l2"><a class="reference internal" href="explain/text/fonts.html">Fonts in Matplotlib</a></li> 472<li class="toctree-l2"><a class="reference internal" href="explain/text/mathtext.html">Writing mathematical expressions</a></li> 473<li class="toctree-l2"><a class="reference internal" href="explain/text/pgf.html">Text rendering with XeLaTeX/LuaLaTeX via the <code class="docutils literal notranslate"><span class="pre">pgf</span></code> backend</a></li> 474<li class="toctree-l2"><a class="reference internal" href="explain/text/text_intro.html">Text in Matplotlib</a></li> 475<li class="toctree-l2"><a class="reference internal" href="explain/text/text_props.html">Text properties and layout</a></li> 476 477<li class="toctree-l2"><a class="reference internal" href="explain/text/usetex.html">Text rendering with LaTeX</a></li> 478</ul> 479</details></li> 480</ul> 481<ul class="nav bd-sidenav"> 482<li class="toctree-l1 has-children"><a class="reference internal" href="explain/animations/index.html">Animations using Matplotlib</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 483<li class="toctree-l2"><a class="reference internal" href="explain/animations/animations.html">Animations using Matplotlib</a></li> 484<li class="toctree-l2"><a class="reference internal" href="explain/animations/blitting.html">Faster rendering by using blitting</a></li> 485</ul> 486</details></li> 487</ul> 488<ul class="nav bd-sidenav"> 489<li class="toctree-l1 has-children"><a class="reference internal" href="explain/toolkits/index.html">User Toolkits</a>
489<details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 490<li class="toctree-l2"><a class="reference internal" href="explain/toolkits/axisartist.html">The axisartist toolkit</a></li> 491<li class="toctree-l2"><a class="reference internal" href="explain/toolkits/axes_grid.html">The axes_grid1 toolkit</a></li> 492<li class="toctree-l2"><a class="reference internal" href="explain/toolkits/mplot3d.html">The mplot3d toolkit</a></li> 493</ul> 494</details></li> 495</ul> 496<ul class="nav bd-sidenav"> 497<li class="toctree-l1"><a class="reference internal" href="getting_started/index.html">Getting started</a></li> 498<li class="toctree-l1 has-children"><a class="reference internal" href="../install/index.html">Installation</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul> 499<li class="toctree-l2"><a class="reference internal" href="../install/environment_variables_faq.html">Environment variables</a></li> 500<li class="toctree-l2"><a class="reference internal" href="../install/dependencies.html">Dependencies</a></li> 501</ul> 502</details></li> 503<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li> 504</ul> 505</div> 506</nav></div> 507 </div> 508 509 510 <div class="sidebar-primary-items__end sidebar-primary__section"> 511 <div class="sidebar-primary-item"> 512<div id="ethical-ad-placement" 513 class="flat" 514 data-ea-publisher="readthedocs" 515 data-ea-type="readthedocs-sidebar" 516 data-ea-manual="true"> 517</div></div> 518 </div> 519 520 521 </div> 522 523 <main id="main-content" class="bd-main" role="main"> 524 525 526 <div class="bd-content"> 527 <div class="bd-article-container"> 528 529 <div class="bd-header-article d-print-none"> 530<div class="header-article-items header-article__inner"> 531 532 <div class="header-article-items__start"> 533 534 <div class="header-article-item"> 535 536<nav aria-label="Breadcrumb" class="d-print-none"> 537 <ul class="bd-breadcrumbs"> 538 539 <li class="breadcrumb-item breadcrumb-home"> 540 <a href="../index.html" class="nav-link" aria-label="Home"> 541 <i class="fa-solid fa-home"></i> 542 </a> 543 </li> 544 <li class="breadcrumb-item active" aria-current="page"><span class="ellipsis">Using Matplotlib</span></li> 545 </ul> 546</nav> 547</div> 548 549 </div> 550 551 552</div> 553</div> 554 555 556 557 558<div id="searchbox"></div> 559 <article class="bd-article"> 560 561 <section id="using-matplotlib"> 562<span id="users-guide-index"></span><h1>Using Matplotlib<a class="headerlink" href="#using-matplotlib" title="Link to this heading">#</a></h1> 563<div class="sd-container-fluid sd-sphinx-override sd-mb-4 docutils"> 564<div class="sd-row sd-row-cols-1 sd-row-cols-xs-1 sd-row-cols-sm-1 sd-row-cols-md-2 sd-row-cols-lg-2 docutils"> 565<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 566<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 567<div class="sd-card-body docutils"> 568<div class="toctree-wrapper compound"> 569<ul> 570<li class="toctree-l1"><a class="reference internal" href="explain/quick_start.html">Quick start guide</a><ul> 571<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#a-simple-example">A simple example</a></li> 572<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#parts-of-a-figure">Parts of a Figure</a></li> 573<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#types-of-inputs-to-plotting-functions">Types of inputs to plotting functions</a></li> 574<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#coding-styles">Coding styles</a></li> 575<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#styling-artists">Styling Artists</a></li> 576<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#labelling-plots">Labelling plots</a></li> 577<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#axis-scales-and-ticks">Axis scales and ticks</a></li> 578<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#color-mapped-data">Color mapped data</a></li> 579<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#working-with-multiple-figures-and-axes">Working with multiple Figures and Axes</a></li> 580<li class="toctree-l2"><a class="reference internal" href="explain/quick_start.html#more-reading">More reading</a></li> 581</ul> 582</li> 583</ul> 584</div> 585<div class="toctree-wrapper compound"> 586<ul> 587<li class="toctree-l1"><a class="reference internal" href="faq.html">Frequently Asked Questions</a></li> 588</ul> 589</div> 590</div> 591</div> 592</div> 593<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 594<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docut
594ils"> 595<div class="sd-card-body docutils"> 596<div class="toctree-wrapper compound"> 597<ul> 598<li class="toctree-l1"><a class="reference internal" href="explain/figure/index.html">Figures and backends</a><ul> 599<li class="toctree-l2"><a class="reference internal" href="explain/figure/figure_intro.html">Introduction to figures</a></li> 600<li class="toctree-l2"><a class="reference internal" href="explain/figure/backends.html">Output backends</a></li> 601<li class="toctree-l2"><a class="reference internal" href="explain/figure/api_interfaces.html">Matplotlib Application Interfaces (APIs)</a></li> 602<li class="toctree-l2"><a class="reference internal" href="explain/figure/interactive.html">Interacting with figures</a></li> 603<li class="toctree-l2"><a class="reference internal" href="explain/figure/interactive_guide.html">Interactive figures and asynchronous programming</a></li> 604<li class="toctree-l2"><a class="reference internal" href="explain/figure/event_handling.html">Event handling</a></li> 605<li class="toctree-l2"><a class="reference internal" href="explain/figure/writing_a_backend_pyplot_interface.html">Writing a backend -- the pyplot interface</a></li> 606</ul> 607</li> 608</ul> 609</div> 610</div> 611</div> 612</div> 613<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 614<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 615<div class="sd-card-body docutils"> 616<div class="toctree-wrapper compound"> 617<ul> 618<li class="toctree-l1"><a class="reference internal" href="explain/axes/index.html">Axes and subplots</a><ul> 619<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_intro.html">Introduction to Axes (or Subplots)</a></li> 620<li class="toctree-l2"><a class="reference internal" href="explain/axes/arranging_axes.html">Arranging multiple Axes in a Figure</a></li> 621<li class="toctree-l2"><a class="reference internal" href="explain/axes/colorbar_placement.html">Placing colorbars</a></li> 622<li class="toctree-l2"><a class="reference internal" href="explain/axes/autoscale.html">Axis autoscaling</a></li> 623<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_scales.html">Axis scales</a></li> 624<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_ticks.html">Axis ticks</a></li> 625<li class="toctree-l2"><a class="reference internal" href="explain/axes/axes_units.html">Plotting dates and strings</a></li> 626<li class="toctree-l2"><a class="reference internal" href="explain/axes/legend_guide.html">Legends</a></li> 627<li class="toctree-l2"><a class="reference internal" href="explain/axes/mosaic.html">Subplot mosaic</a></li> 628<li class="toctree-l2"><a class="reference internal" href="explain/axes/constrainedlayout_guide.html">Constrained layout guide</a></li> 629<li class="toctree-l2"><a class="reference internal" href="explain/axes/tight_layout_guide.html">Tight layout guide (mildly discouraged)</a></li> 630</ul> 631</li> 632</ul> 633</div> 634</div> 635</div> 636</div> 637<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 638<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 639<div class="sd-card-body docutils"> 640<div class="toctree-wrapper compound"> 641<ul> 642<li class="toctree-l1"><a class="reference internal" href="explain/artists/index.html">Artists</a><ul> 643<li class="toctree-l2"><a class="reference internal" href="explain/artists/artist_intro.html">Introduction to Artists</a></li> 644<li class="toctree-l2"><a class="reference internal" href="explain/artists/color_cycle.html">Automated color cycle</a></li> 645<li class="toctree-l2"><a class="reference internal" href="explain/artists/performance.html">Optimizing Artists for performance</a></li> 646<li class="toctree-l2"><a class="reference internal" href="explain/artists/paths.html">Paths</a></li> 647<li class="toctree-l2"><a class="reference internal" href="explain/artists/patheffects_guide.html">Path effects guide</a></li> 648<li class="toctree-l2"><a class="reference internal" href="explain/artists/imshow_extent.html">Understanding the extent keyword argument of imshow</a></li> 649<li class="toctree-l2"><a class="reference internal" href="explain/artists/transforms_tutorial.html">
649Transformations Tutorial</a></li> 650</ul> 651</li> 652</ul> 653</div> 654</div> 655</div> 656</div> 657<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 658<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 659<div class="sd-card-body docutils"> 660<div class="toctree-wrapper compound"> 661<ul> 662<li class="toctree-l1"><a class="reference internal" href="explain/configuration.html">Matplotlib configuration - rcParams</a></li> 663</ul> 664</div> 665<div class="toctree-wrapper compound"> 666<ul> 667<li class="toctree-l1"><a class="reference internal" href="explain/customizing.html">Customizing Matplotlib with style sheets and rcParams</a><ul> 668<li class="toctree-l2"><a class="reference internal" href="explain/customizing.html#runtime-rc-settings">Runtime rc settings</a></li> 669<li class="toctree-l2"><a class="reference internal" href="explain/customizing.html#using-style-sheets">Using style sheets</a></li> 670<li class="toctree-l2"><a class="reference internal" href="explain/customizing.html#the-matplotlibrc-file">The <code class="file docutils literal notranslate"><span class="pre">matplotlibrc</span></code> file</a></li> 671</ul> 672</li> 673</ul> 674</div> 675</div> 676</div> 677</div> 678<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 679<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 680<div class="sd-card-body docutils"> 681<div class="toctree-wrapper compound"> 682<ul> 683<li class="toctree-l1"><a class="reference internal" href="explain/colors/index.html">Colors</a><ul> 684<li class="toctree-l2"><a class="reference internal" href="explain/colors/colorbar_only.html">Customized Colorbars Tutorial</a></li> 685<li class="toctree-l2"><a class="reference internal" href="explain/colors/colormap-manipulation.html">Creating Colormaps in Matplotlib</a></li> 686<li class="toctree-l2"><a class="reference internal" href="explain/colors/colormapnorms.html">Colormap normalization</a></li> 687<li class="toctree-l2"><a class="reference internal" href="explain/colors/colormaps.html">Choosing Colormaps in Matplotlib</a></li> 688<li class="toctree-l2"><a class="reference internal" href="explain/colors/colors.html">Specifying colors</a></li> 689</ul> 690</li> 691</ul> 692</div> 693</div> 694</div> 695</div> 696<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 697<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 698<div class="sd-card-body docutils"> 699<div class="toctree-wrapper compound"> 700<ul> 701<li class="toctree-l1"><a class="reference internal" href="explain/text/index.html">Text</a><ul> 702<li class="toctree-l2"><a class="reference internal" href="explain/text/annotations.html">Annotations</a></li> 703<li class="toctree-l2"><a class="reference internal" href="explain/text/fonts.html">Fonts in Matplotlib</a></li> 704<li class="toctree-l2"><a class="reference internal" href="explain/text/mathtext.html">Writing mathematical expressions</a></li> 705<li class="toctree-l2"><a class="reference internal" href="explain/text/pgf.html">Text rendering with XeLaTeX/LuaLaTeX via the <code class="docutils literal notranslate"><span class="pre">pgf</span></code> backend</a></li> 706<li class="toctree-l2"><a class="reference internal" href="explain/text/text_intro.html">Text in Matplotlib</a></li> 707<li class="toctree-l2"><a class="reference internal" href="explain/text/text_props.html">Text properties and layout</a></li> 708<li class="toctree-l2"><a class="reference internal" href="explain/text/text_props.html#default-font">Default Font</a></li> 709<li class="toctree-l2"><a class="reference internal" href="explain/text/usetex.html">Text rendering with LaTeX</a></li> 710</ul> 711</li> 712</ul> 713</div> 714</div> 715</div> 716</div> 717<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 718<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docutils"> 719<div class="sd-card-body docutils"> 720<div class="toctree-wrapper compound"> 721<ul> 722<li class="toctree-l1"><a class="reference internal" href="explain/animations/index.html">Animations using Matplotlib</a><ul> 723<li class="toctree-l2"><a class="reference internal" href="explain/animations/animations.html">Animations using Matplotlib</a></li> 724<li class="toctree-l2"><a class="reference internal" href="explain/animations/blitting.html">Faster rendering by using blitting</a></li> 725</ul> 726</li> 727</ul> 728</div> 729</div> 730</div> 731</div> 732<div class="sd-col sd-d-flex-row sd-p-2 docutils"> 733<div class="sd-card sd-sphinx-override sd-w-100 sd-shadow-sm docut
733ils"> 734<div class="sd-card-body docutils"> 735<div class="toctree-wrapper compound"> 736<ul> 737<li class="toctree-l1"><a class="reference internal" href="explain/toolkits/index.html">User Toolkits</a><ul> 738<li class="toctree-l2"><a class="reference internal" href="explain/toolkits/axisartist.html">The axisartist toolkit</a></li> 739<li class="toctree-l2"><a class="reference internal" href="explain/toolkits/axes_grid.html">The axes_grid1 toolkit</a></li> 740<li class="toctree-l2"><a class="reference internal" href="explain/toolkits/mplot3d.html">The mplot3d toolkit</a></li> 741</ul> 742</li> 743</ul> 744</div> 745</div> 746</div> 747</div> 748</div> 749</div> 750<div class="toctree-wrapper compound"> 751</div> 752</section> 753 754 755 </article> 756 757 758 759 760 761 </div> 762 763 764 765 766 </div> 767 <footer class="bd-footer-content"> 768 769 </footer> 770 771 </main> 772 </div> 773 </div> 774 775 <!-- Scripts loaded after <body> so the DOM is not blocked --> 776
776<script defer src="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf" type="6241aca2045e30e90785789a-text/javascript"></script>
vendor: 1 bytes, line 776
776
777<script defer src="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf" type="6241aca2045e30e90785789a-text/javascript"></script>
777 778 779 <footer class="bd-footer"> 780<div class="bd-footer__inner bd-page-width"> 781 782 <div class="footer-items__start"> 783 784 <div class="footer-item"> 785 786 <p class="copyright"> 787 788 © Copyright 2002â2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012â2026 The Matplotlib development team. 789 <br/> 790 791 </p> 792</div> 793 794 <div class="footer-item"> 795 796 <p class="sphinx-version"> 797 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 9.1.0. 798 <br/> 799 </p> 800</div> 801 802 <div class="footer-item"> 803 <p class="sphinx-version"> 804 Built from v3.11.2-1-g879ad8ebba. 805 <br/> 806 </p> 807</div> 808 809 </div> 810 811 812 813 <div class="footer-items__end"> 814 815 <div class="footer-item"> 816<p class="theme-version"> 817 <!-- # L10n: Setting the PST URL as an argument as this does not need to be localized --> 818 Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.16.1. 819</p></div> 820 821 </div> 822 823</div> 824 825 </footer>
vendor: 145 bytes, lines 825-826
825 826 <script src="/cdn-cgi/scripts/7d0fa10a/cloudflare-static/rocket-loader.min.js" data-cf-settings="6241aca2045e30e90785789a-|49" defer></script>
826<script type="module" src="https://static.cloudflareinsights.com/beacon.min.js/v31edd6df95cf4e85bb4c19e7a9bdbcba1788362987495" integrity="sha512-iIg7k2xntmwu6/uSb5tpc/hySgZc4eoL31yB29W6tJFo2akwjPWcEqnCEdJvGexCL0KEQwVYv5BlowfhVz26hg==" data-cf-beacon='{"version":"2024.11.0","token":"0175964edbd040b6ac0bff692bcb22ec","spa":2}' crossorigin="anonymous"></script>
826 827</body> 828</html>
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.