gallery/widgets/buttons.html


<!DOCTYPE html>


<html lang="en" data-content_root="../../" >

  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

    <title>Buttons &#8212; Matplotlib 3.11.0.dev777+ga30354ee8b documentation</title>
  
  
  <script data-cfasync="false">
    document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
    document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
  </script>
  
  <!-- Loaded before other Sphinx assets -->
  <link href="../../_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
<link href="../../_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
<link href="../../_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />

  
  <link href="../../_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
  <link rel="preload" as="font" type="font/woff2" crossorigin href="../../_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
<link rel="preload" as="font" type="font/woff2" crossorigin href="../../_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
<link rel="preload" as="font" type="font/woff2" crossorigin href="../../_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />

    <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
    <link rel="stylesheet" type="text/css" href="../../_static/css/style.css?v=f16eb9d3" />
    <link rel="stylesheet" type="text/css" href="../../_static/graphviz.css?v=4ae1632d" />
    <link rel="stylesheet" type="text/css" href="../../_static/plot_directive.css" />
    <link rel="stylesheet" type="text/css" href="../../_static/copybutton.css?v=76b2166b" />
    <link rel="stylesheet" type="text/css" href="../../_static/sg_gallery.css?v=d2d258e8" />
    <link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-binder.css?v=f4aeca0c" />
    <link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-dataframe.css?v=2082cf3c" />
    <link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-rendered-html.css?v=1277b6f3" />
    <link rel="stylesheet" type="text/css" href="../../_static/sphinx-design.min.css?v=95c83b7e" />
    <link rel="stylesheet" type="text/css" href="../../_static/mpl.css?v=5a7e13c8" />
  
  <!-- Pre-loaded scripts that we'll load fully later -->
  <link rel="preload" as="script" href="../../_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
<link rel="preload" as="script" href="../../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
  <script src="../../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>

    <script src="../../_static/documentation_options.js?v=826a5f29"></script>
    <script src="../../_static/doctools.js?v=9bcbadda"></script>
    <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
    <script src="../../_static/clipboard.min.js?v=a7894cd8"></script>
    <script src="../../_static/copybutton.js?v=ccdb6887"></script>
    <script src="../../_static/design-tabs.js?v=f930bc37"></script>
    <script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>
    <script>DOCUMENTATION_OPTIONS.pagename = 'gallery/widgets/buttons';</script>
    <script>
        DOCUMENTATION_OPTIONS.theme_version = '0.15.4';
        DOCUMENTATION_OPTIONS.theme_switcher_json_url = 'https://matplotlib.org/devdocs/_static/switcher.json?v3.10.1-777-ga30354ee8b';
        DOCUMENTATION_OPTIONS.theme_switcher_version_match = 'dev';
        DOCUMENTATION_OPTIONS.show_version_warning_banner = true;
        </script>
    <link rel="canonical" href="https://matplotlib.org/stable/gallery/widgets/buttons.html" />
    <link rel="search" type="application/opensearchdescription+xml"
          title="Search within Matplotlib 3.11.0.dev777+ga30354ee8b documentation"
          href="../../_static/opensearch.xml"/>
    <link rel="icon" href="../../_static/favicon.ico"/>
    <link rel="search" title="Search" href="../../search.html" />
    <link rel="next" title="Check buttons" href="check_buttons.html" />
    <link rel="prev" title="Annotated cursor" href="annotated_cursor.html" />
  <meta name="viewport" content="width=device-width, initial-scale=1"/>
  <meta name="docsearch:language" content="en"/>
    <meta name="docbuild:last-update" content="Feb 27, 2025"/>
  </head>
  
  
  <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">

  
  <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
  
  <div id="pst-scroll-pixel-helper"></div>
  
  <button type="button" class="btn rounded-pill" id="pst-back-to-top">
    <i class="fa-solid fa-arrow-up"></i>Back to top</button>

  
  <input type="checkbox"
          class="sidebar-toggle"
          id="pst-primary-sidebar-checkbox"/>
  <label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
  
  <input type="checkbox"
          class="sidebar-toggle"
          id="pst-secondary-sidebar-checkbox"/>
  <label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
  
  <div class="search-button__wrapper">
    <div class="search-button__overlay"></div>
    <div class="search-button__search-container">
<form class="bd-search d-flex align-items-center"
      action="../../search.html"
      method="get">
  <i class="fa-solid fa-magnifying-glass"></i>
  <input type="search"
         class="form-control"
         name="q"
         id="search-input"
         placeholder="Search the docs ..."
         aria-label="Search the docs ..."
         autocomplete="off"
         autocorrect="off"
         autocapitalize="off"
         spellcheck="false"/>
  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
</form></div>
  </div>

  <div class="pst-async-banner-revealer d-none">
  <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
</div>

  
    <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
<div class="bd-header__inner bd-page-width">
  <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
    <span class="fa-solid fa-bars"></span>
  </button>
  
  
  <div class="col-lg-3 navbar-header-items__start">
    
      <div class="navbar-item">

  
<a class="navbar-brand logo" href="https://matplotlib.org/stable/">
  
  
    <img src="../../_static/logo_light.svg" class="logo__image only-light" alt="Matplotlib 3.11.0.dev777+ga30354ee8b documentation - Home"/>
    <script>document.write(`<img src="../../_static/logo_dark.svg" class="logo__image only-dark" alt="Matplotlib 3.11.0.dev777+ga30354ee8b documentation - Home"/>`);</script>
  
  
</a></div>
    
  </div>
  
  <div class="col-lg-9 navbar-header-items">
    
    <div class="me-auto navbar-header-items__center">
      
        <div class="navbar-item"><ul id="navbar-main-elements" class="navbar-nav">
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../plot_types/index.html">Plot types</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../users/index.html">User guide</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../tutorials/index.html">Tutorials</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../index.html">Examples</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../api/index.html">Reference</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../devel/index.html">Contribute</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../users/release_notes.html">Releases</a>
  </li>
</ul></div>
      
    </div>
    
    
    <div class="navbar-header-items__end">
      
        <div class="navbar-item navbar-persistent--container">
          

<script>
document.write(`
  <button class="btn btn-sm pst-navbar-icon search-button search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
    <i class="fa-solid fa-magnifying-glass fa-lg"></i>
  </button>
`);
</script>
        </div>
      
      
        <div class="navbar-item">

<script>
document.write(`
  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
  </button>
`);
</script></div>
      
        <div class="navbar-item">
<script>
document.write(`
  <div class="version-switcher__container dropdown">
    <button id="pst-version-switcher-button-2"
      type="button"
      class="version-switcher__button btn btn-sm dropdown-toggle"
      data-bs-toggle="dropdown"
      aria-haspopup="listbox"
      aria-controls="pst-version-switcher-list-2"
      aria-label="Version switcher list"
    >
      Choose version  <!-- this text may get changed later by javascript -->
      <span class="caret"></span>
    </button>
    <div id="pst-version-switcher-list-2"
      class="version-switcher__menu dropdown-menu list-group-flush py-0"
      role="listbox" aria-labelledby="pst-version-switcher-button-2">
      <!-- dropdown will be populated by javascript on page load -->
    </div>
  </div>
`);
</script></div>
      
        <div class="navbar-item"><ul class="navbar-icon-links"
    aria-label="Icon Links">
        <li class="nav-item">
          
          
          <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>
            <span class="sr-only">Gitter</span></a>
        </li>
        <li class="nav-item">
          
          
          <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>
            <span class="sr-only">Discourse</span></a>
        </li>
        <li class="nav-item">
          
          
          <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>
            <span class="sr-only">GitHub</span></a>
        </li>
</ul></div>
      
    </div>
    
  </div>
  
  
    <div class="navbar-persistent--mobile">

<script>
document.write(`
  <button class="btn btn-sm pst-navbar-icon search-button search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
    <i class="fa-solid fa-magnifying-glass fa-lg"></i>
  </button>
`);
</script>
    </div>
  

</div>

    </header>
  

  <div class="bd-container">
    <div class="bd-container__inner bd-page-width">
      
      
      <div class="bd-sidebar-primary bd-sidebar">
        

  <div class="sidebar-header-items sidebar-primary__section">
    
    
      <div class="sidebar-header-items__center">
        
          
            <div class="navbar-item"><ul id="navbar-main-elements" class="navbar-nav">
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../plot_types/index.html">Plot types</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../users/index.html">User guide</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../tutorials/index.html">Tutorials</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../index.html">Examples</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../api/index.html">Reference</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../devel/index.html">Contribute</a>
  </li>
  <li class="nav-item">
    <a class="reference internal nav-link" href="../../users/release_notes.html">Releases</a>
  </li>
</ul></div>
          
        
      </div>
    
    
      <div class="sidebar-header-items__end">
        
          <div class="navbar-item">

<script>
document.write(`
  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
  </button>
`);
</script></div>
        
          <div class="navbar-item">
<script>
document.write(`
  <div class="version-switcher__container dropdown">
    <button id="pst-version-switcher-button-3"
      type="button"
      class="version-switcher__button btn btn-sm dropdown-toggle"
      data-bs-toggle="dropdown"
      aria-haspopup="listbox"
      aria-controls="pst-version-switcher-list-3"
      aria-label="Version switcher list"
    >
      Choose version  <!-- this text may get changed later by javascript -->
      <span class="caret"></span>
    </button>
    <div id="pst-version-switcher-list-3"
      class="version-switcher__menu dropdown-menu list-group-flush py-0"
      role="listbox" aria-labelledby="pst-version-switcher-button-3">
      <!-- dropdown will be populated by javascript on page load -->
    </div>
  </div>
`);
</script></div>
        
          <div class="navbar-item"><ul class="navbar-icon-links"
    aria-label="Icon Links">
        <li class="nav-item">
          
          
          <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>
            <span class="sr-only">Gitter</span></a>
        </li>
        <li class="nav-item">
          
          
          <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>
            <span class="sr-only">Discourse</span></a>
        </li>
        <li class="nav-item">
          
          
          <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>
            <span class="sr-only">GitHub</span></a>
        </li>
</ul></div>
        
      </div>
    
  </div>
  
    <div class="sidebar-primary-items__start sidebar-primary__section">
        <div class="sidebar-primary-item">
<nav class="bd-docs-nav bd-links"
     aria-label="Section Navigation">
  <p class="bd-links__title" role="heading" aria-level="1">Section Navigation</p>
  <div class="bd-toc-item navbar-nav"><ul class="current nav bd-sidenav">
<li class="toctree-l1 has-children"><a class="reference internal" href="../lines_bars_and_markers/index.html">Lines, bars and markers</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/axline.html">Infinite lines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/bar_colors.html">Bar chart with individual bar colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/bar_label_demo.html">Bar chart with labels</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/bar_stacked.html">Stacked bar chart</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/barchart.html">Grouped bar chart with labels</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/barh.html">Horizontal bar chart</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/broken_barh.html">Broken horizontal bars</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/capstyle.html">CapStyle</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/categorical_variables.html">Plotting categorical variables</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/cohere.html">Plotting the coherence of two signals</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/csd_demo.html">Cross spectral density (CSD)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/curve_error_band.html">Curve with error band</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/errorbar_limits_simple.html">Errorbar limit selection</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/errorbar_subsample.html">Errorbar subsampling</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/eventcollection_demo.html">EventCollection Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/eventplot_demo.html">Eventplot demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/fill.html">Filled polygon</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/fill_between_alpha.html"><code class="docutils literal notranslate"><span class="pre">fill_between</span></code> with transparency</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/fill_between_demo.html">Fill the area between two lines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/fill_betweenx_demo.html">Fill the area between two vertical lines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/gradient_bar.html">Bar chart with gradients</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/hat_graph.html">Hat graph</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/horizontal_barchart_distribution.html">Discrete distribution as horizontal bar chart</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/joinstyle.html">JoinStyle</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/line_demo_dash_control.html">Dashed line style configuration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/lines_with_ticks_demo.html">Lines with a ticked patheffect</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/linestyles.html">Linestyles</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/marker_reference.html">Marker reference</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/markevery_demo.html">Markevery Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/masked_demo.html">Plotting masked and NaN values</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/multicolored_line.html">Multicolored lines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/multivariate_marker_plot.html">Mapping marker properties to multivariate data</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/psd_demo.html">Power spectral density (PSD)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/scatter_demo2.html">Scatter Demo2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/scatter_hist.html">Scatter plot with histograms</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/scatter_masked.html">Scatter plot with masked values</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/scatter_star_poly.html">Marker examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/scatter_with_legend.html">Scatter plot with a legend</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/simple_plot.html">Line plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/span_regions.html">Shade regions defined by a logical mask using fill_between</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/spectrum_demo.html">Spectrum representations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/stackplot_demo.html">Stackplots and streamgraphs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/stairs_demo.html">Stairs Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/stem_plot.html">Stem plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/step_demo.html">Step Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/timeline.html">Timeline with lines, dates, and text</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/vline_hline_demo.html">hlines and vlines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../lines_bars_and_markers/xcorr_acorr_demo.html">Cross- and auto-correlation</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../images_contours_and_fields/index.html">Images, contours and fields</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/affine_image.html">Affine transform of an image</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/barb_demo.html">Wind barbs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/barcode_demo.html">Barcode</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/colormap_interactive_adjustment.html">Interactive adjustment of colormap range</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/colormap_normalizations.html">Colormap normalizations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/colormap_normalizations_symlognorm.html">Colormap normalizations SymLogNorm</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contour_corner_mask.html">Contour corner mask</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contour_demo.html">Contour Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contour_image.html">Contour image</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contour_label_demo.html">Contour Label Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contourf_demo.html">Contourf demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contourf_hatching.html">Contourf hatching</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contourf_log.html">Contourf and log color scale</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/contours_in_optimization_demo.html">Contouring the solution space of optimizations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/demo_bboximage.html">BboxImage Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/figimage_demo.html">Figimage Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_annotated_heatmap.html">Annotated heatmap</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_antialiasing.html">Image resampling</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_clip_path.html">Clipping images with patches</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_demo.html">Many ways to plot images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_exact_placement.html">Placing images, preserving relative sizes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_masked.html">Image with masked values</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_nonuniform.html">Image nonuniform</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_transparency_blend.html">Blend transparency with color in 2D images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/image_zcoord.html">Modifying the coordinate formatter</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/interpolation_methods.html">Interpolations for imshow</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/irregulardatagrid.html">Contour plot of irregularly spaced data</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/layer_images.html">Layer images with alpha blending</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/matshow.html">Visualize matrices with matshow</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/multi_image.html">Multiple images with one colorbar</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/pcolor_demo.html">pcolor images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/pcolormesh_grids.html">pcolormesh grids and shading</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/pcolormesh_levels.html">pcolormesh</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/plot_streamplot.html">Streamplot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/quadmesh_demo.html">QuadMesh Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/quiver_demo.html">Advanced quiver and quiverkey functions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/quiver_simple_demo.html">Quiver Simple Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/shading_example.html">Shading example</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/specgram_demo.html">Spectrogram</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/spy_demos.html">Spy Demos</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/tricontour_demo.html">Tricontour Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/tricontour_smooth_delaunay.html">Tricontour Smooth Delaunay</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/tricontour_smooth_user.html">Tricontour Smooth User</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/trigradient_demo.html">Trigradient Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/triinterp_demo.html">Triinterp Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/tripcolor_demo.html">Tripcolor Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/triplot_demo.html">Triplot Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../images_contours_and_fields/watermark_image.html">Watermark image</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../subplots_axes_and_figures/index.html">Subplots, axes and figures</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/align_labels_demo.html">Align labels and titles</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/auto_subplots_adjust.html">Programmatically control subplot adjustment</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axes_box_aspect.html">Axes box aspect</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axes_demo.html">Axes Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axes_margins.html">Controlling view limits using margins and sticky_edges</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axes_props.html">Axes properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axes_zoom_effect.html">Axes zoom effect</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axhspan_demo.html">Draw regions that span an Axes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axis_equal_demo.html">Equal axis aspect ratio</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/axis_labels_demo.html">Axis label position</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/broken_axis.html">Broken axis</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/custom_figure_class.html">Custom Figure subclasses</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/demo_constrained_layout.html">Resize Axes with constrained layout</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/demo_tight_layout.html">Resize Axes with tight layout</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/fahrenheit_celsius_scales.html">Different scales on the same Axes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/figure_size_units.html">Figure size in different units</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/figure_title.html">Figure labels: suptitle, supxlabel, supylabel</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/ganged_plots.html">Adjacent subplots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/geo_demo.html">Geographic Projections</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/gridspec_and_subplots.html">Combine two subplots using subplots and GridSpec</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/gridspec_customization.html">GridSpec with variable sizes and spacing</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/gridspec_multicolumn.html">Gridspec for multi-column/row subplot layouts</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/gridspec_nested.html">Nested Gridspecs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/invert_axes.html">Inverted axis</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/multiple_figs_demo.html">Manage multiple figures in pyplot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/secondary_axis.html">Secondary Axis</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/share_axis_lims_views.html">Share axis limits and views</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/shared_axis_demo.html">Shared axis</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/subfigures.html">Figure subfigures</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/subplot.html">Multiple subplots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/subplot2grid.html">subplot2grid</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/subplots_adjust.html">Subplots spacings and margins</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/subplots_demo.html">Create multiple subplots using <code class="docutils literal notranslate"><span class="pre">plt.subplots</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/two_scales.html">Plots with different scales</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subplots_axes_and_figures/zoom_inset_axes.html">Zoom region inset Axes</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../statistics/index.html">Statistics</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../statistics/boxplot.html">Artist customization in box plots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/boxplot_color.html">Box plots with custom fill colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/boxplot_demo.html">Boxplots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/boxplot_vs_violin.html">Box plot vs. violin plot comparison</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/bxp.html">Separate calculation and plotting of boxplots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/confidence_ellipse.html">Plot a confidence ellipse of a two-dimensional dataset</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/customized_violin.html">Violin plot customization</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/errorbar.html">Errorbar function</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/errorbar_features.html">Different ways of specifying error bars</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/errorbar_limits.html">Including upper and lower limits in error bars</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/errorbars_and_boxes.html">Create boxes from error bars using PatchCollection</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/hexbin_demo.html">Hexagonal binned plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/hist.html">Histograms</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/histogram_bihistogram.html">Bihistogram</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/histogram_cumulative.html">Cumulative distributions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/histogram_histtypes.html">Demo of the histogram function's different <code class="docutils literal notranslate"><span class="pre">histtype</span></code> settings</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/histogram_multihist.html">The histogram (hist) function with multiple data sets</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/histogram_normalization.html">Histogram bins, density, and weight</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/multiple_histograms_side_by_side.html">Multiple histograms side by side</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/time_series_histogram.html">Time Series Histogram</a></li>
<li class="toctree-l2"><a class="reference internal" href="../statistics/violinplot.html">Violin plot basics</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../pie_and_polar_charts/index.html">Pie and polar charts</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/pie_features.html">Pie charts</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/bar_of_pie.html">Bar of pie</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/nested_pie.html">Nested pie charts</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/pie_and_donut_labels.html">A pie and a donut with labels</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/polar_bar.html">Bar chart on polar axis</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/polar_demo.html">Polar plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/polar_error_caps.html">Error bar rendering on polar axis</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/polar_legend.html">Polar legend</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pie_and_polar_charts/polar_scatter.html">Scatter plot on polar axis</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../text_labels_and_annotations/index.html">Text, labels and annotations</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/accented_text.html">Accented text</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/angle_annotation.html">Scale invariant angle label</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/angles_on_bracket_arrows.html">Angle annotations on bracket arrows</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/annotate_transform.html">Annotate transform</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/annotation_basic.html">Annotating a plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/annotation_demo.html">Annotate plots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/annotation_polar.html">Annotate polar plots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/arrow_demo.html">Arrow Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/autowrap.html">Auto-wrap text</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/custom_legends.html">Compose custom legends</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/date.html">Date tick labels</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/demo_annotation_box.html">AnnotationBbox demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/demo_text_path.html">Using a text as a Path</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/demo_text_rotation_mode.html">Text rotation mode</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/dfrac_demo.html">The difference between \dfrac and \frac</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/engineering_formatter.html">Format ticks using engineering notation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/fancyarrow_demo.html">Annotation arrow style reference</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/fancytextbox_demo.html">Styling text boxes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/figlegend_demo.html">Figure legend demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/font_family_rc.html">Configure the font family</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/font_file.html">Using ttf font files</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/font_table.html">Font table</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/fonts_demo.html">Fonts demo (object-oriented style)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/fonts_demo_kw.html">Fonts demo (keyword arguments)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/label_subplots.html">Labelling subplots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/legend.html">Legend using pre-defined labels</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/legend_demo.html">Legend Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/line_with_text.html">Artist within an artist</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/mathtext_asarray.html">Convert texts to images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/mathtext_demo.html">Mathtext</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/mathtext_examples.html">Mathematical expressions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/mathtext_fontfamily_example.html">Math fontfamily</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/multiline.html">Multiline</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/placing_text_boxes.html">Placing text boxes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/rainbow_text.html">Concatenate text objects with different properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/stix_fonts_demo.html">STIX Fonts</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/tex_demo.html">Render math equations using TeX</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/text_alignment.html">Text alignment</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/text_commands.html">Text properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/text_fontdict.html">Controlling style of text and labels using a dictionary</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/text_rotation_relative_to_line.html">Text rotation angle in data coordinates</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/titles_demo.html">Title positioning</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/unicode_minus.html">Unicode minus</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/usetex_baseline_test.html">Usetex text baseline</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/usetex_fonteffects.html">Usetex font effects</a></li>
<li class="toctree-l2"><a class="reference internal" href="../text_labels_and_annotations/watermark_text.html">Text watermark</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../color/index.html">Color</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../color/color_demo.html">Color Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/color_by_yvalue.html">Color by y-value</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/color_cycle_default.html">Colors in the default property cycle</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/color_sequences.html">Named color sequences</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/colorbar_basics.html">Colorbar</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/colormap_reference.html">Colormap reference</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/custom_cmap.html">Create a colormap from a list of colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/individual_colors_from_cmap.html">Selecting individual colors from a colormap</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/named_colors.html">List of named colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="../color/set_alpha.html">Ways to set a color's alpha value</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../shapes_and_collections/index.html">Shapes and collections</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/arrow_guide.html">Arrow guide</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/artist_reference.html">Reference for Matplotlib artists</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/collections.html">Line, Poly and RegularPoly Collection with autoscaling</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/compound_path.html">Compound path</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/dolphin.html">Dolphins</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/donut.html">Mmh Donuts!!!</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/ellipse_arrow.html">Ellipse with orientation arrow demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/ellipse_collection.html">Ellipse Collection</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/ellipse_demo.html">Ellipse Demo</a></li>

<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/fancybox_demo.html">Drawing fancy boxes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/hatch_demo.html">Hatch demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/hatch_style_reference.html">Hatch style reference</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/hatchcolor_demo.html">Hatchcolor Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/line_collection.html">Plot multiple lines using a LineCollection</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/patch_collection.html">Circles, Wedges and Polygons</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/path_patch.html">PathPatch object</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/quad_bezier.html">Bezier curve</a></li>
<li class="toctree-l2"><a class="reference internal" href="../shapes_and_collections/scatter.html">Scatter plot</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../style_sheets/index.html">Style sheets</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/bmh.html">Bayesian Methods for Hackers style sheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/dark_background.html">Dark background style sheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/fivethirtyeight.html">FiveThirtyEight style sheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/ggplot.html">ggplot style sheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/grayscale.html">Grayscale style sheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/petroff10.html">Petroff10 style sheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/plot_solarizedlight2.html">Solarized Light stylesheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../style_sheets/style_sheets_reference.html">Style sheets reference</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../pyplots/index.html">Module - pyplot</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../pyplots/pyplot_simple.html">Simple plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pyplots/pyplot_text.html">Text and mathtext using pyplot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pyplots/pyplot_three.html">Multiple lines using pyplot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pyplots/pyplot_two_subplots.html">Two subplots using pyplot</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../axes_grid1/index.html">Module - axes_grid1</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_anchored_direction_arrows.html">Anchored Direction Arrow</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_axes_divider.html">Axes divider</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_axes_grid.html">Demo Axes Grid</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_axes_grid2.html">Axes Grid2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_axes_hbox_divider.html">HBoxDivider and VBoxDivider demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_axes_rgb.html">Show RGB channels using RGBAxes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_colorbar_with_axes_divider.html">Colorbar with AxesDivider</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_colorbar_with_inset_locator.html">Control the position and size of a colorbar with Inset Axes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_edge_colorbar.html">Per-row or per-column colorbars</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_fixed_size_axes.html">Axes with a fixed physical size</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/demo_imagegrid_aspect.html">ImageGrid cells with a fixed aspect ratio</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/inset_locator_demo.html">Inset locator demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/inset_locator_demo2.html">Inset locator demo 2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/make_room_for_ylabel_using_axesgrid.html">Make room for ylabel using axes_grid</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/parasite_simple.html">Parasite Simple</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/parasite_simple2.html">Parasite Simple2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/scatter_hist_locatable_axes.html">Align histogram to scatter plot using locatable Axes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/simple_anchored_artists.html">Simple Anchored Artists</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/simple_axes_divider1.html">Simple Axes Divider 1</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/simple_axes_divider3.html">Simple axes divider 3</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/simple_axesgrid.html">Simple ImageGrid</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/simple_axesgrid2.html">Simple ImageGrid 2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axes_grid1/simple_axisline4.html">Simple Axisline4</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../axisartist/index.html">Module - axisartist</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/axis_direction.html">Axis Direction</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_axis_direction.html">axis_direction demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_axisline_style.html">Axis line styles</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_curvelinear_grid.html">Curvilinear grid demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_curvelinear_grid2.html">Demo CurveLinear Grid2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_floating_axes.html"><code class="docutils literal notranslate"><span class="pre">floating_axes</span></code> features</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_floating_axis.html">floating_axis demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_parasite_axes.html">Parasite Axes demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_parasite_axes2.html">Parasite axis demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_ticklabel_alignment.html">Ticklabel alignment</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/demo_ticklabel_direction.html">Ticklabel direction</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/simple_axis_direction01.html">Simple axis direction</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/simple_axis_direction03.html">Simple axis tick label and tick directions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/simple_axis_pad.html">Simple axis pad</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/simple_axisartist1.html">Custom spines with axisartist</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/simple_axisline.html">Simple Axisline</a></li>
<li class="toctree-l2"><a class="reference internal" href="../axisartist/simple_axisline3.html">Simple Axisline3</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../showcase/index.html">Showcase</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../showcase/anatomy.html">Anatomy of a figure</a></li>
<li class="toctree-l2"><a class="reference internal" href="../showcase/firefox.html">Firefox</a></li>
<li class="toctree-l2"><a class="reference internal" href="../showcase/integral.html">Integral as the area under a curve</a></li>
<li class="toctree-l2"><a class="reference internal" href="../showcase/mandelbrot.html">Shaded &amp; power normalized rendering</a></li>
<li class="toctree-l2"><a class="reference internal" href="../showcase/pan_zoom_overlap.html">Pan/zoom events of overlapping axes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../showcase/stock_prices.html">Stock prices over 32 years</a></li>
<li class="toctree-l2"><a class="reference internal" href="../showcase/xkcd.html">XKCD</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../animation/index.html">Animation</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../animation/animate_decay.html">Decay</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/animated_histogram.html">Animated histogram</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/animation_demo.html">pyplot animation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/bayes_update.html">The Bayes update</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/double_pendulum.html">The double pendulum problem</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/dynamic_image.html">Animated image using a precomputed list of images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/frame_grabbing_sgskip.html">Frame grabbing</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/multiple_axes.html">Multiple Axes animation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/pause_resume.html">Pause and resume an animation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/rain.html">Rain simulation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/random_walk.html">Animated 3D random walk</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/simple_anim.html">Animated line plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/simple_scatter.html">Animated scatter saved as GIF</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/strip_chart.html">Oscilloscope</a></li>
<li class="toctree-l2"><a class="reference internal" href="../animation/unchained.html">Matplotlib unchained</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../event_handling/index.html">Event handling</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/close_event.html">Close event</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/coords_demo.html">Mouse move and click events</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/cursor_demo.html">Cross-hair cursor</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/data_browser.html">Data browser</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/figure_axes_enter_leave.html">Figure/Axes enter and leave events</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/ginput_manual_clabel_sgskip.html">Interactive functions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/image_slices_viewer.html">Scroll event</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/keypress_demo.html">Keypress event</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/lasso_demo.html">Lasso Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/legend_picking.html">Legend picking</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/looking_glass.html">Looking glass</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/path_editor.html">Path editor</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/pick_event_demo.html">Pick event demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/pick_event_demo2.html">Pick event demo 2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/poly_editor.html">Polygon editor</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/pong_sgskip.html">Pong</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/resample.html">Resampling Data</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/timers.html">Timers</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/trifinder_event_demo.html">Trifinder Event Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/viewlims.html">Viewlims</a></li>
<li class="toctree-l2"><a class="reference internal" href="../event_handling/zoom_window.html">Zoom modifies other Axes</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../misc/index.html">Miscellaneous</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../misc/anchored_artists.html">Anchored Artists</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/bbox_intersect.html">Identify whether artists intersect</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/contour_manual.html">Manual Contour</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/coords_report.html">Coords Report</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/custom_projection.html">Custom projection</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/customize_rc.html">Customize Rc</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/demo_agg_filter.html">AGG filter</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/demo_ribbon_box.html">Ribbon box</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/fig_x.html">Add lines directly to a figure</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/fill_spiral.html">Fill spiral</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/findobj_demo.html">Findobj Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/font_indexing.html">Font indexing</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/ftface_props.html">Font properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/histogram_path.html">Building histograms using Rectangles and PolyCollections</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/hyperlinks_sgskip.html">Hyperlinks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/image_thumbnail_sgskip.html">Image thumbnail</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/keyword_plotting.html">Plotting with keywords</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/logos2.html">Matplotlib logo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/multipage_pdf.html">Multipage PDF</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/multiprocess_sgskip.html">Multiprocessing</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/packed_bubbles.html">Packed-bubble chart</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/patheffect_demo.html">Patheffect Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/print_stdout_sgskip.html">Print image to stdout</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/rasterization_demo.html">Rasterization for vector graphics</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/set_and_get.html">Set and get properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/svg_filter_line.html">Apply SVG filter to a line</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/svg_filter_pie.html">SVG filter pie</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/table_demo.html">Table Demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/tickedstroke_demo.html">TickedStroke patheffect</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/transoffset.html">transforms.offset_copy</a></li>
<li class="toctree-l2"><a class="reference internal" href="../misc/zorder_demo.html">Zorder Demo</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../mplot3d/index.html">3D plotting</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/2dcollections3d.html">Plot 2D data on 3D plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/3d_bars.html">Demo of 3D bar charts</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/axlim_clip.html">Clip the data to the axes view limits</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/bars3d.html">Create 2D bar graphs in different planes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/box3d.html">3D box surface plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/contour3d.html">Plot contour (level) curves in 3D</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/contour3d_2.html">Plot contour (level) curves in 3D using the extend3d option</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/contour3d_3.html">Project contour profiles onto a graph</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/contourf3d.html">Filled contours</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/contourf3d_2.html">Project filled contour onto a graph</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/custom_shaded_3d_surface.html">Custom hillshading in a 3D surface plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/errorbar3d.html">3D errorbars</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/fillbetween3d.html">Fill between 3D lines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/fillunder3d.html">Fill under 3D line graphs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/hist3d.html">Create 3D histogram of 2D data</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/imshow3d.html">2D images in 3D</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/intersecting_planes.html">Intersecting planes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/lines3d.html">Parametric curve</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/lorenz_attractor.html">Lorenz attractor</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/mixed_subplots.html">2D and 3D Axes in same figure</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/offset.html">Automatic text offsetting</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/pathpatch3d.html">Draw flat objects in 3D plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/polys3d.html">Generate 3D polygons</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/projections.html">3D plot projection types</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/quiver3d.html">3D quiver plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/rotate_axes3d_sgskip.html">Rotating a 3D plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/scatter3d.html">3D scatterplot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/stem3d_demo.html">3D stem</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/subplot3d.html">3D plots as subplots</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/surface3d.html">3D surface (colormap)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/surface3d_2.html">3D surface (solid color)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/surface3d_3.html">3D surface (checkerboard)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/surface3d_radial.html">3D surface with polar coordinates</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/text3d.html">Text annotations in 3D</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/tricontour3d.html">Triangular 3D contour plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/tricontourf3d.html">Triangular 3D filled contour plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/trisurf3d.html">Triangular 3D surfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/trisurf3d_2.html">More triangular 3D surfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/view_planes_3d.html">Primary 3D view planes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/voxels.html">3D voxel / volumetric plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/voxels_numpy_logo.html">3D voxel plot of the NumPy logo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/voxels_rgb.html">3D voxel / volumetric plot with RGB colors</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/voxels_torus.html">3D voxel / volumetric plot with cylindrical coordinates</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/wire3d.html">3D wireframe plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/wire3d_animation_sgskip.html">Animate a 3D wireframe plot</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mplot3d/wire3d_zero_stride.html">3D wireframe plots in one direction</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../scales/index.html">Scales</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../scales/scales.html">Scales overview</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/asinh_demo.html">Asinh scale</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/aspect_loglog.html">Loglog aspect</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/custom_scale.html">Custom scale</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/log_demo.html">Log scale</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/logit_demo.html">Logit scale</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/power_norm.html">Exploring normalizations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../scales/symlog_demo.html">Symlog scale</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../specialty_plots/index.html">Specialty plots</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/advanced_hillshading.html">Hillshading</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/anscombe.html">Anscombe's quartet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/hinton_demo.html">Hinton diagrams</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/ishikawa_diagram.html">Ishikawa Diagram</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/leftventricle_bullseye.html">Left ventricle bullseye</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/mri_with_eeg.html">MRI with EEG</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/radar_chart.html">Radar chart (aka spider or star chart)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/sankey_basics.html">The Sankey class</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/sankey_links.html">Long chain of connections using Sankey</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/sankey_rankine.html">Rankine power cycle</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/skewt.html">SkewT-logP diagram: using transforms and custom projections</a></li>
<li class="toctree-l2"><a class="reference internal" href="../specialty_plots/topographic_hillshading.html">Topographic hillshading</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../spines/index.html">Spines</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../spines/spines.html">Spines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../spines/spine_placement_demo.html">Spine placement</a></li>
<li class="toctree-l2"><a class="reference internal" href="../spines/spines_dropped.html">Dropped spines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../spines/multiple_yaxis_with_spines.html">Multiple y-axis with Spines</a></li>
<li class="toctree-l2"><a class="reference internal" href="../spines/centered_spines_with_arrows.html">Centered spines with arrows</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../ticks/index.html">Ticks</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../ticks/auto_ticks.html">Automatically setting tick positions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/centered_ticklabels.html">Center labels between ticks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/colorbar_tick_labelling_demo.html">Colorbar Tick Labelling</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/custom_ticker1.html">Custom Ticker</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/date_concise_formatter.html">Format date ticks using ConciseDateFormatter</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/date_demo_convert.html">Date Demo Convert</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/date_demo_rrule.html">Placing date ticks using recurrence rules</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/date_formatters_locators.html">Date tick locators and formatters</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/date_index_formatter.html">Custom tick formatter for time series</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/date_precision_and_epochs.html">Date precision and epochs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/dollar_ticks.html">Dollar ticks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/engformatter_offset.html">SI prefixed offsets and natural order of magnitudes</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/fig_axes_customize_simple.html">Fig Axes Customize Simple</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/major_minor_demo.html">Major and minor ticks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/multilevel_ticks.html">Multilevel (nested) ticks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/scalarformatter.html">The default tick formatter</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/tick-formatters.html">Tick formatters</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/tick-locators.html">Tick locators</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/tick_label_right.html">Set default y-axis tick labels on the right</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/tick_labels_from_values.html">Setting tick labels from a list of values</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/tick_xlabel_top.html">Move x-axis tick labels to the top</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/ticklabels_rotation.html">Rotated tick labels</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ticks/ticks_too_many.html">Fixing too many ticks</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../units/index.html">Units</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../units/annotate_with_units.html">Annotation with units</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/artist_tests.html">Artist tests</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/bar_demo2.html">Bar demo with units</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/bar_unit_demo.html">Group barchart with units</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/basic_units.html">Basic units</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/ellipse_with_units.html">Ellipse with units</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/evans_test.html">Evans test</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/radian_demo.html">Radian ticks</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/units_sample.html">Inches and centimeters</a></li>
<li class="toctree-l2"><a class="reference internal" href="../units/units_scatter.html">Unit handling</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../user_interfaces/index.html">Embedding Matplotlib in graphical user interfaces</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/canvasagg.html">CanvasAgg demo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_gtk3_panzoom_sgskip.html">Embed in GTK3 with a navigation toolbar</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_gtk3_sgskip.html">Embed in GTK3</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_gtk4_panzoom_sgskip.html">Embed in GTK4 with a navigation toolbar</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_gtk4_sgskip.html">Embed in GTK4</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_qt_sgskip.html">Embed in Qt</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_tk_sgskip.html">Embed in Tk</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_wx2_sgskip.html">Embed in wx #2</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_wx3_sgskip.html">Embed in wx #3</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_wx4_sgskip.html">Embed in wx #4</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_in_wx5_sgskip.html">Embed in wx #5</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/embedding_webagg_sgskip.html">Embedding WebAgg</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/fourier_demo_wx_sgskip.html">Fourier Demo WX</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/gtk3_spreadsheet_sgskip.html">GTK3 spreadsheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/gtk4_spreadsheet_sgskip.html">GTK4 spreadsheet</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/mathtext_wx_sgskip.html">Display mathtext in WX</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/mpl_with_glade3_sgskip.html">Matplotlib with Glade 3</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/mplcvd.html">mplcvd -- an example of figure hook</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/pylab_with_gtk3_sgskip.html">pyplot with GTK3</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/pylab_with_gtk4_sgskip.html">pyplot with GTK4</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/svg_histogram_sgskip.html">SVG Histogram</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/svg_tooltip_sgskip.html">SVG Tooltip</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/toolmanager_sgskip.html">Tool Manager</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/web_application_server_sgskip.html">Embed in a web application server (Flask)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../user_interfaces/wxcursor_demo_sgskip.html">Add a cursor in WX</a></li>
</ul>
</details></li>
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Widgets</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="annotated_cursor.html">Annotated cursor</a></li>
<li class="toctree-l2 current active"><a class="current reference internal" href="#">Buttons</a></li>
<li class="toctree-l2"><a class="reference internal" href="check_buttons.html">Check buttons</a></li>
<li class="toctree-l2"><a class="reference internal" href="cursor.html">Cursor</a></li>
<li class="toctree-l2"><a class="reference internal" href="lasso_selector_demo_sgskip.html">Lasso Selector</a></li>
<li class="toctree-l2"><a class="reference internal" href="menu.html">Menu</a></li>
<li class="toctree-l2"><a class="reference internal" href="mouse_cursor.html">Mouse Cursor</a></li>
<li class="toctree-l2"><a class="reference internal" href="multicursor.html">Multicursor</a></li>
<li class="toctree-l2"><a class="reference internal" href="polygon_selector_demo.html">Select indices from a collection using polygon selector</a></li>
<li class="toctree-l2"><a class="reference internal" href="polygon_selector_simple.html">Polygon Selector</a></li>
<li class="toctree-l2"><a class="reference internal" href="radio_buttons.html">Radio Buttons</a></li>
<li class="toctree-l2"><a class="reference internal" href="range_slider.html">Image scaling using a RangeSlider</a></li>
<li class="toctree-l2"><a class="reference internal" href="rectangle_selector.html">Rectangle and ellipse selectors</a></li>
<li class="toctree-l2"><a class="reference internal" href="slider_demo.html">Slider</a></li>
<li class="toctree-l2"><a class="reference internal" href="slider_snap_demo.html">Snap sliders to discrete values</a></li>
<li class="toctree-l2"><a class="reference internal" href="span_selector.html">Span Selector</a></li>
<li class="toctree-l2"><a class="reference internal" href="textbox.html">Textbox</a></li>
</ul>
</details></li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../userdemo/index.html">Userdemo</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../userdemo/demo_gridspec06.html">Nested GridSpecs</a></li>
</ul>
</details></li>
</ul>
</div>
</nav></div>
    </div>
  
  
  <div class="sidebar-primary-items__end sidebar-primary__section">
  </div>
  
  <div id="rtd-footer-container"></div>


      </div>
      
      <main id="main-content" class="bd-main" role="main">
        
        
          <div class="bd-content">
            <div class="bd-article-container">
              
              <div class="bd-header-article d-print-none">
<div class="header-article-items header-article__inner">
  
    <div class="header-article-items__start">
      
        <div class="header-article-item">


<nav aria-label="Breadcrumb" class="d-print-none">
  <ul class="bd-breadcrumbs">
    
    <li class="breadcrumb-item breadcrumb-home">
      <a href="../../index.html" class="nav-link" aria-label="Home">
        <i class="fa-solid fa-home"></i>
      </a>
    </li>
    
    <li class="breadcrumb-item"><a href="../index.html" class="nav-link">Examples</a></li>
    
    
    <li class="breadcrumb-item"><a href="index.html" class="nav-link">Widgets</a></li>
    
    <li class="breadcrumb-item active" aria-current="page">Buttons</li>
  </ul>
</nav>
</div>
      
    </div>
  
  
</div>
</div>
              
              
<div id="searchbox"></div>
                <article class="bd-article">
                  
  <div class="sphx-glr-download-link-note admonition note">
<p class="admonition-title">Note</p>
<p><a class="reference internal" href="#sphx-glr-download-gallery-widgets-buttons-py"><span class="std std-ref">Go to the end</span></a>
to download the full example code.</p>
</div>
<section class="sphx-glr-example-title" id="buttons">
<span id="sphx-glr-gallery-widgets-buttons-py"></span><h1>Buttons<a class="headerlink" href="#buttons" title="Link to this heading">#</a></h1>
<p>Constructing a simple button GUI to modify a sine wave.</p>
<p>The <code class="docutils literal notranslate"><span class="pre">next</span></code> and <code class="docutils literal notranslate"><span class="pre">previous</span></code> button widget helps visualize the wave with
new frequencies.</p>
<div class="highlight-Python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span><span class="w"> </span><span class="nn">matplotlib.pyplot</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">plt</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">numpy</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">np</span>

<span class="kn">from</span><span class="w"> </span><span class="nn">matplotlib.widgets</span><span class="w"> </span><span class="kn">import</span> <a href="../../api/widgets_api.html#matplotlib.widgets.Button" title="matplotlib.widgets.Button" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-class"><span class="n">Button</span></a>

<a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">freqs</span></a> <span class="o">=</span> <a href="https://numpy.org/doc/stable/reference/generated/numpy.arange.html#numpy.arange" title="numpy.arange" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-function"><span class="n">np</span><span class="o">.</span><span class="n">arange</span></a><span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">20</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span>

<a href="../../api/_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure" class="sphx-glr-backref-module-matplotlib-figure sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">fig</span></a><span class="p">,</span> <a href="../../api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">ax</span></a> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.pyplot.subplots.html#matplotlib.pyplot.subplots" title="matplotlib.pyplot.subplots" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function"><span class="n">plt</span><span class="o">.</span><span class="n">subplots</span></a><span class="p">()</span>
<a href="../../api/_as_gen/matplotlib.figure.Figure.subplots_adjust.html#matplotlib.figure.Figure.subplots_adjust" title="matplotlib.figure.Figure.subplots_adjust" class="sphx-glr-backref-module-matplotlib-figure sphx-glr-backref-type-py-method"><span class="n">fig</span><span class="o">.</span><span class="n">subplots_adjust</span></a><span class="p">(</span><span class="n">bottom</span><span class="o">=</span><span class="mf">0.2</span><span class="p">)</span>
<a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">t</span></a> <span class="o">=</span> <a href="https://numpy.org/doc/stable/reference/generated/numpy.arange.html#numpy.arange" title="numpy.arange" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-function"><span class="n">np</span><span class="o">.</span><span class="n">arange</span></a><span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">,</span> <span class="mf">0.001</span><span class="p">)</span>
<a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">s</span></a> <span class="o">=</span> <a href="https://numpy.org/doc/stable/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">np</span><span class="o">.</span><span class="n">sin</span></a><span class="p">(</span><span class="mi">2</span><span class="o">*</span><a href="https://docs.python.org/3/library/functions.html#float" title="builtins.float" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">np</span><span class="o">.</span><span class="n">pi</span></a><span class="o">*</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">freqs</span></a><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">*</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">t</span></a><span class="p">)</span>
<a href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D" title="matplotlib.lines.Line2D" class="sphx-glr-backref-module-matplotlib-lines sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">l</span></a><span class="p">,</span> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.axes.Axes.plot.html#matplotlib.axes.Axes.plot" title="matplotlib.axes.Axes.plot" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-method"><span class="n">ax</span><span class="o">.</span><span class="n">plot</span></a><span class="p">(</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">t</span></a><span class="p">,</span> <a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">s</span></a><span class="p">,</span> <span class="n">lw</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>


<span class="k">class</span><span class="w"> </span><span class="nc">Index</span><span class="p">:</span>
    <span class="n">ind</span> <span class="o">=</span> <span class="mi">0</span>

    <span class="k">def</span><span class="w"> </span><span class="nf">next</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">ind</span> <span class="o">+=</span> <span class="mi">1</span>
        <span class="n">i</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">ind</span> <span class="o">%</span> <span class="nb">len</span><span class="p">(</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">freqs</span></a><span class="p">)</span>
        <span class="n">ydata</span> <span class="o">=</span> <a href="https://numpy.org/doc/stable/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">np</span><span class="o">.</span><span class="n">sin</span></a><span class="p">(</span><span class="mi">2</span><span class="o">*</span><a href="https://docs.python.org/3/library/functions.html#float" title="builtins.float" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">np</span><span class="o">.</span><span class="n">pi</span></a><span class="o">*</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">freqs</span></a><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">*</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">t</span></a><span class="p">)</span>
        <a href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D.set_ydata" title="matplotlib.lines.Line2D.set_ydata" class="sphx-glr-backref-module-matplotlib-lines sphx-glr-backref-type-py-method"><span class="n">l</span><span class="o">.</span><span class="n">set_ydata</span></a><span class="p">(</span><span class="n">ydata</span><span class="p">)</span>
        <a href="../../api/_as_gen/matplotlib.pyplot.draw.html#matplotlib.pyplot.draw" title="matplotlib.pyplot.draw" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function"><span class="n">plt</span><span class="o">.</span><span class="n">draw</span></a><span class="p">()</span>

    <span class="k">def</span><span class="w"> </span><span class="nf">prev</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
        <span class="bp">self</span><span class="o">.</span><span class="n">ind</span> <span class="o">-=</span> <span class="mi">1</span>
        <span class="n">i</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">ind</span> <span class="o">%</span> <span class="nb">len</span><span class="p">(</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">freqs</span></a><span class="p">)</span>
        <span class="n">ydata</span> <span class="o">=</span> <a href="https://numpy.org/doc/stable/reference/generated/numpy.ufunc.html#numpy.ufunc" title="numpy.ufunc" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">np</span><span class="o">.</span><span class="n">sin</span></a><span class="p">(</span><span class="mi">2</span><span class="o">*</span><a href="https://docs.python.org/3/library/functions.html#float" title="builtins.float" class="sphx-glr-backref-module-builtins sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">np</span><span class="o">.</span><span class="n">pi</span></a><span class="o">*</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">freqs</span></a><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">*</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">t</span></a><span class="p">)</span>
        <a href="../../api/_as_gen/matplotlib.lines.Line2D.html#matplotlib.lines.Line2D.set_ydata" title="matplotlib.lines.Line2D.set_ydata" class="sphx-glr-backref-module-matplotlib-lines sphx-glr-backref-type-py-method"><span class="n">l</span><span class="o">.</span><span class="n">set_ydata</span></a><span class="p">(</span><span class="n">ydata</span><span class="p">)</span>
        <a href="../../api/_as_gen/matplotlib.pyplot.draw.html#matplotlib.pyplot.draw" title="matplotlib.pyplot.draw" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function"><span class="n">plt</span><span class="o">.</span><span class="n">draw</span></a><span class="p">()</span>

<span class="n">callback</span> <span class="o">=</span> <span class="n">Index</span><span class="p">()</span>
<a href="../../api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">axprev</span></a> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.figure.Figure.add_axes.html#matplotlib.figure.Figure.add_axes" title="matplotlib.figure.Figure.add_axes" class="sphx-glr-backref-module-matplotlib-figure sphx-glr-backref-type-py-method"><span class="n">fig</span><span class="o">.</span><span class="n">add_axes</span></a><span class="p">([</span><span class="mf">0.7</span><span class="p">,</span> <span class="mf">0.05</span><span class="p">,</span> <span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.075</span><span class="p">])</span>
<a href="../../api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">axnext</span></a> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.figure.Figure.add_axes.html#matplotlib.figure.Figure.add_axes" title="matplotlib.figure.Figure.add_axes" class="sphx-glr-backref-module-matplotlib-figure sphx-glr-backref-type-py-method"><span class="n">fig</span><span class="o">.</span><span class="n">add_axes</span></a><span class="p">([</span><span class="mf">0.81</span><span class="p">,</span> <span class="mf">0.05</span><span class="p">,</span> <span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.075</span><span class="p">])</span>
<a href="../../api/widgets_api.html#matplotlib.widgets.Button" title="matplotlib.widgets.Button" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">bnext</span></a> <span class="o">=</span> <a href="../../api/widgets_api.html#matplotlib.widgets.Button" title="matplotlib.widgets.Button" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-class"><span class="n">Button</span></a><span class="p">(</span><a href="../../api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">axnext</span></a><span class="p">,</span> <span class="s1">&#39;Next&#39;</span><span class="p">)</span>
<a href="../../api/widgets_api.html#matplotlib.widgets.Button.on_clicked" title="matplotlib.widgets.Button.on_clicked" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-method"><span class="n">bnext</span><span class="o">.</span><span class="n">on_clicked</span></a><span class="p">(</span><span class="n">callback</span><span class="o">.</span><span class="n">next</span><span class="p">)</span>
<a href="../../api/widgets_api.html#matplotlib.widgets.Button" title="matplotlib.widgets.Button" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">bprev</span></a> <span class="o">=</span> <a href="../../api/widgets_api.html#matplotlib.widgets.Button" title="matplotlib.widgets.Button" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-class"><span class="n">Button</span></a><span class="p">(</span><a href="../../api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">axprev</span></a><span class="p">,</span> <span class="s1">&#39;Previous&#39;</span><span class="p">)</span>
<a href="../../api/widgets_api.html#matplotlib.widgets.Button.on_clicked" title="matplotlib.widgets.Button.on_clicked" class="sphx-glr-backref-module-matplotlib-widgets sphx-glr-backref-type-py-method"><span class="n">bprev</span><span class="o">.</span><span class="n">on_clicked</span></a><span class="p">(</span><span class="n">callback</span><span class="o">.</span><span class="n">prev</span><span class="p">)</span>

<a href="../../api/_as_gen/matplotlib.pyplot.show.html#matplotlib.pyplot.show" title="matplotlib.pyplot.show" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function"><span class="n">plt</span><span class="o">.</span><span class="n">show</span></a><span class="p">()</span>
</pre></div>
</div>
<img src="../../_images/sphx_glr_buttons_001.png" srcset="../../_images/sphx_glr_buttons_001.png, ../../_images/sphx_glr_buttons_001_2_00x.png 2.00x" alt="buttons" class = "sphx-glr-single-img"/><div class="admonition-references admonition">
<p class="admonition-title">References</p>
<p>The use of the following functions, methods, classes and modules is shown
in this example:</p>
<ul class="simple">
<li><p><a class="reference internal" href="../../api/widgets_api.html#matplotlib.widgets.Button" title="matplotlib.widgets.Button"><code class="xref py py-obj docutils literal notranslate"><span class="pre">matplotlib.widgets.Button</span></code></a></p></li>
</ul>
</div>
<div class="sphx-glr-footer sphx-glr-footer-example docutils container" id="sphx-glr-download-gallery-widgets-buttons-py">
<div class="sphx-glr-download sphx-glr-download-jupyter docutils container">
<p><a class="reference download internal" download="" href="../../_downloads/58a1433a8b9b492045a15224c16f35ee/buttons.ipynb"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">Jupyter</span> <span class="pre">notebook:</span> <span class="pre">buttons.ipynb</span></code></a></p>
</div>
<div class="sphx-glr-download sphx-glr-download-python docutils container">
<p><a class="reference download internal" download="" href="../../_downloads/1396177ce1d23fee4cbc40e2635021b2/buttons.py"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">Python</span> <span class="pre">source</span> <span class="pre">code:</span> <span class="pre">buttons.py</span></code></a></p>
</div>
<div class="sphx-glr-download sphx-glr-download-zip docutils container">
<p><a class="reference download internal" download="" href="../../_downloads/eae94f16e63d2f3f633a51325520ac02/buttons.zip"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">zipped:</span> <span class="pre">buttons.zip</span></code></a></p>
</div>
</div>
<p class="sphx-glr-signature"><a class="reference external" href="https://sphinx-gallery.github.io">Gallery generated by Sphinx-Gallery</a></p>
</section>


                </article>
              
              
            </div>
            
            
          </div>
          <footer class="bd-footer-content">
            
          </footer>
        
      </main>
    </div>
  </div>
  
  <!-- Scripts loaded after <body> so the DOM is not blocked -->
  <script src="../../_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
<script src="../../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>

  <footer class="bd-footer">
<div class="bd-footer__inner bd-page-width">
  
    <div class="footer-items__start">
      
        <div class="footer-item">

  <p class="copyright">
    
      © Copyright 2002–2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012–2025 The Matplotlib development team.
      <br/>
    
  </p>
</div>
      
        <div class="footer-item">

  <p class="sphinx-version">
    Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
    <br/>
  </p>
</div>
      
        <div class="footer-item">
  <p class="sphinx-version">
    Built from v3.10.1-777-ga30354ee8b.
    <br/>
  </p>
</div>
      
    </div>
  
  
    <div class="footer-items__end">
      
        <div class="footer-item">
<p class="theme-version">
  Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.15.4.
</p></div>
      
    </div>
  
</div>

  </footer>
  </body>
</html>