<!DOCTYPE html>

<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

    <title>seaborn.objects.Plot.on &#8212; seaborn 0.13.2 documentation</title>
  <script>
    document.documentElement.dataset.mode = localStorage.getItem("mode") || "light";
    document.documentElement.dataset.theme = localStorage.getItem("theme") || "light";
  </script>
  
  <!-- Loaded before other Sphinx assets -->
  <link href="../_static/styles/theme.css?digest=9b1a4fa89bdd0e95b23b" rel="stylesheet">
<link href="../_static/styles/pydata-sphinx-theme.css?digest=9b1a4fa89bdd0e95b23b" rel="stylesheet">

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

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/plot_directive.css" />
    <link rel="stylesheet" type="text/css" href="../_static/copybutton.css" />
    <link rel="stylesheet" type="text/css" href="../_static/design-style.1e8bd061cd6da7fc9cf755528e8ffc24.min.css" />
    <link rel="stylesheet" type="text/css" href="../_static/css/custom.css?v=0.13.2" />
  
  <!-- Pre-loaded scripts that we'll load fully later -->
  <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=9b1a4fa89bdd0e95b23b">

    <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
    <script src="../_static/jquery.js"></script>
    <script src="../_static/underscore.js"></script>
    <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
    <script src="../_static/doctools.js"></script>
    <script src="../_static/sphinx_highlight.js"></script>
    <script src="../_static/clipboard.min.js"></script>
    <script src="../_static/copybutton.js"></script>
    <script src="../_static/design-tabs.js"></script>
    <script>DOCUMENTATION_OPTIONS.pagename = 'generated/seaborn.objects.Plot.on';</script>
    <link rel="shortcut icon" href="../_static/favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="seaborn.objects.Plot.plot" href="seaborn.objects.Plot.plot.html" />
    <link rel="prev" title="seaborn.objects.Plot.theme" href="seaborn.objects.Plot.theme.html" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <meta name="docsearch:language" content="en">
  </head>
  
  
  <body data-spy="scroll" data-target="#bd-toc-nav" data-offset="180" data-default-mode="light">

  
  <input type="checkbox" class="sidebar-toggle" name="__primary" id="__primary">
  <label class="overlay overlay-primary" for="__primary"></label>

  
  <input type="checkbox" class="sidebar-toggle" name="__secondary" id="__secondary">
  <label class="overlay overlay-secondary" for="__secondary"></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="icon fas fa-search"></i>
  <input type="search" class="form-control" name="q" id="search-input" placeholder="Search the docs ..." aria-label="Search the docs ..." autocomplete="off" >
  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
</form>
    </div>
  </div>

  
  <nav class="bd-header navbar navbar-expand-lg bd-navbar" id="navbar-main"><div class="bd-header__inner container-xl">
  <label class="sidebar-toggle primary-toggle" for="__primary">
      <span class="fas fa-bars"></span>
  </label>
  <div id="navbar-start">
    
    
  


<a class="navbar-brand logo" href="../index.html">
  
  
  
  
  
  
    <img src="../_static/logo-wide-lightbg.svg" class="logo__image only-light" alt="Logo image">
    <img src="../_static/logo-wide-lightbg.svg" class="logo__image only-dark" alt="Logo image">
  
  
</a>
    
  </div>

  
  <div class="col-lg-9 navbar-header-items">
    <div id="navbar-center" class="mr-auto">
      
      <div class="navbar-center-item">
        <ul id="navbar-main-elements" class="navbar-nav">
    <li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../installing.html">
  Installing
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../examples/index.html">
  Gallery
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../tutorial.html">
  Tutorial
 </a>
</li>

<li class="toctree-l1 current active nav-item">
 <a class="reference internal nav-link" href="../api.html">
  API
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../whatsnew/index.html">
  Releases
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../citing.html">
  Citing
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../faq.html">
  FAQ
 </a>
</li>

</ul>
      </div>
      
    </div>

    <div id="navbar-end">
      <div class="navbar-end-item navbar-end__search-button-container">
        
<button class="btn btn-sm navbar-btn search-button search-button__button" title="Search">
  <i class="fas fa-search"></i>
</button>
      </div>
      
      <div class="navbar-end-item">
        <ul id="navbar-icon-links" class="navbar-nav" aria-label="Icon Links">
        <li class="nav-item">
          
          
          
          
          
          
          <a href="https://github.com/mwaskom/seaborn" title="GitHub" class="nav-link" rel="noopener" target="_blank"><span><i class="fab fa-github"></i></span>
            <label class="sr-only">GitHub</label></a>
        </li>
        <li class="nav-item">
          
          
          
          
          
          
          <a href="https://stackoverflow.com/tags/seaborn" title="StackOverflow" class="nav-link" rel="noopener" target="_blank"><span><i class="fab fa-stack-overflow"></i></span>
            <label class="sr-only">StackOverflow</label></a>
        </li>
        <li class="nav-item">
          
          
          
          
          
          
          <a href="https://twitter.com/michaelwaskom" title="Twitter" class="nav-link" rel="noopener" target="_blank"><span><i class="fab fa-twitter"></i></span>
            <label class="sr-only">Twitter</label></a>
        </li>
      </ul>
      </div>
      
    </div>
  </div>


  
  <div class="search-button-container--mobile">
<button class="btn btn-sm navbar-btn search-button search-button__button" title="Search">
  <i class="fas fa-search"></i>
</button>
  </div>

  
  <label class="sidebar-toggle secondary-toggle" for="__secondary">
      <span class="fas fa-outdent"></span>
  </label>
  

</div>
  </nav>
  

  <div class="bd-container container-xl">
    <div class="bd-container__inner row">
      
      <div class="bd-sidebar-primary bd-sidebar">
        
  
  <div class="sidebar-header-items sidebar-primary__section">
    <p class="sidebar-header-items__title" role="heading" aria-level="1" aria-label="Navigation">
      Site Navigation
    </p>
    
    
      <div class="sidebar-header-items__center">
      
      <div class="navbar-center-item">
        <ul id="navbar-main-elements" class="navbar-nav">
    <li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../installing.html">
  Installing
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../examples/index.html">
  Gallery
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../tutorial.html">
  Tutorial
 </a>
</li>

<li class="toctree-l1 current active nav-item">
 <a class="reference internal nav-link" href="../api.html">
  API
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../whatsnew/index.html">
  Releases
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../citing.html">
  Citing
 </a>
</li>

<li class="toctree-l1 nav-item">
 <a class="reference internal nav-link" href="../faq.html">
  FAQ
 </a>
</li>

</ul>
      </div>
      
      </div>
    

    
    
    <div class="sidebar-header-items__end">
      
      <div class="navbar-end-item">
        <ul id="navbar-icon-links" class="navbar-nav" aria-label="Icon Links">
        <li class="nav-item">
          
          
          
          
          
          
          <a href="https://github.com/mwaskom/seaborn" title="GitHub" class="nav-link" rel="noopener" target="_blank"><span><i class="fab fa-github"></i></span>
            <label class="sr-only">GitHub</label></a>
        </li>
        <li class="nav-item">
          
          
          
          
          
          
          <a href="https://stackoverflow.com/tags/seaborn" title="StackOverflow" class="nav-link" rel="noopener" target="_blank"><span><i class="fab fa-stack-overflow"></i></span>
            <label class="sr-only">StackOverflow</label></a>
        </li>
        <li class="nav-item">
          
          
          
          
          
          
          <a href="https://twitter.com/michaelwaskom" title="Twitter" class="nav-link" rel="noopener" target="_blank"><span><i class="fab fa-twitter"></i></span>
            <label class="sr-only">Twitter</label></a>
        </li>
      </ul>
      </div>
      
    </div>
    
  </div>

  
  <div class="sidebar-start-items sidebar-primary__section">
    <div class="sidebar-start-items__item"><nav class="bd-links" id="bd-docs-nav" aria-label="Section navigation">
  <div class="bd-toc-item navbar-nav">
    <ul class="current nav bd-sidenav">
 <li class="toctree-l1 current active has-children">
  <a class="reference internal" href="seaborn.objects.Plot.html">
   seaborn.objects.Plot
  </a>
  <input checked="" class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" type="checkbox"/>
  <label class="toctree-toggle" for="toctree-checkbox-1">
   <i class="fas fa-chevron-down">
   </i>
  </label>
  <ul class="current">
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.add.html">
     seaborn.objects.Plot.add
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.scale.html">
     seaborn.objects.Plot.scale
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.facet.html">
     seaborn.objects.Plot.facet
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.pair.html">
     seaborn.objects.Plot.pair
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.layout.html">
     seaborn.objects.Plot.layout
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.label.html">
     seaborn.objects.Plot.label
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.limit.html">
     seaborn.objects.Plot.limit
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.share.html">
     seaborn.objects.Plot.share
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.theme.html">
     seaborn.objects.Plot.theme
    </a>
   </li>
   <li class="toctree-l2 current active">
    <a class="current reference internal" href="#">
     seaborn.objects.Plot.on
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.plot.html">
     seaborn.objects.Plot.plot
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.save.html">
     seaborn.objects.Plot.save
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.objects.Plot.show.html">
     seaborn.objects.Plot.show
    </a>
   </li>
  </ul>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Dot.html">
   seaborn.objects.Dot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Dots.html">
   seaborn.objects.Dots
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Line.html">
   seaborn.objects.Line
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Lines.html">
   seaborn.objects.Lines
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Path.html">
   seaborn.objects.Path
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Paths.html">
   seaborn.objects.Paths
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Dash.html">
   seaborn.objects.Dash
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Range.html">
   seaborn.objects.Range
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Bar.html">
   seaborn.objects.Bar
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Bars.html">
   seaborn.objects.Bars
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Area.html">
   seaborn.objects.Area
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Band.html">
   seaborn.objects.Band
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Text.html">
   seaborn.objects.Text
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Agg.html">
   seaborn.objects.Agg
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Est.html">
   seaborn.objects.Est
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Count.html">
   seaborn.objects.Count
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Hist.html">
   seaborn.objects.Hist
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.KDE.html">
   seaborn.objects.KDE
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Perc.html">
   seaborn.objects.Perc
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.PolyFit.html">
   seaborn.objects.PolyFit
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Dodge.html">
   seaborn.objects.Dodge
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Jitter.html">
   seaborn.objects.Jitter
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Norm.html">
   seaborn.objects.Norm
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Stack.html">
   seaborn.objects.Stack
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Shift.html">
   seaborn.objects.Shift
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Boolean.html">
   seaborn.objects.Boolean
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Continuous.html">
   seaborn.objects.Continuous
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Nominal.html">
   seaborn.objects.Nominal
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Temporal.html">
   seaborn.objects.Temporal
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Mark.html">
   seaborn.objects.Mark
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Stat.html">
   seaborn.objects.Stat
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Move.html">
   seaborn.objects.Move
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.objects.Scale.html">
   seaborn.objects.Scale
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.relplot.html">
   seaborn.relplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.scatterplot.html">
   seaborn.scatterplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.lineplot.html">
   seaborn.lineplot
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.displot.html">
   seaborn.displot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.histplot.html">
   seaborn.histplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.kdeplot.html">
   seaborn.kdeplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.ecdfplot.html">
   seaborn.ecdfplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.rugplot.html">
   seaborn.rugplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.distplot.html">
   seaborn.distplot
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.catplot.html">
   seaborn.catplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.stripplot.html">
   seaborn.stripplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.swarmplot.html">
   seaborn.swarmplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.boxplot.html">
   seaborn.boxplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.violinplot.html">
   seaborn.violinplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.boxenplot.html">
   seaborn.boxenplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.pointplot.html">
   seaborn.pointplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.barplot.html">
   seaborn.barplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.countplot.html">
   seaborn.countplot
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.lmplot.html">
   seaborn.lmplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.regplot.html">
   seaborn.regplot
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.residplot.html">
   seaborn.residplot
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.heatmap.html">
   seaborn.heatmap
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.clustermap.html">
   seaborn.clustermap
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1 has-children">
  <a class="reference internal" href="seaborn.FacetGrid.html">
   seaborn.FacetGrid
  </a>
  <input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" type="checkbox"/>
  <label class="toctree-toggle" for="toctree-checkbox-2">
   <i class="fas fa-chevron-down">
   </i>
  </label>
  <ul>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.__init__.html">
     seaborn.FacetGrid.__init__
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.add_legend.html">
     seaborn.FacetGrid.add_legend
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.apply.html">
     seaborn.FacetGrid.apply
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.despine.html">
     seaborn.FacetGrid.despine
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.facet_axis.html">
     seaborn.FacetGrid.facet_axis
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.facet_data.html">
     seaborn.FacetGrid.facet_data
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.map.html">
     seaborn.FacetGrid.map
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.map_dataframe.html">
     seaborn.FacetGrid.map_dataframe
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.pipe.html">
     seaborn.FacetGrid.pipe
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.refline.html">
     seaborn.FacetGrid.refline
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.savefig.html">
     seaborn.FacetGrid.savefig
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set.html">
     seaborn.FacetGrid.set
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set_axis_labels.html">
     seaborn.FacetGrid.set_axis_labels
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set_titles.html">
     seaborn.FacetGrid.set_titles
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set_xlabels.html">
     seaborn.FacetGrid.set_xlabels
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set_xticklabels.html">
     seaborn.FacetGrid.set_xticklabels
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set_ylabels.html">
     seaborn.FacetGrid.set_ylabels
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.set_yticklabels.html">
     seaborn.FacetGrid.set_yticklabels
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.tick_params.html">
     seaborn.FacetGrid.tick_params
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.FacetGrid.tight_layout.html">
     seaborn.FacetGrid.tight_layout
    </a>
   </li>
  </ul>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.pairplot.html">
   seaborn.pairplot
  </a>
 </li>
 <li class="toctree-l1 has-children">
  <a class="reference internal" href="seaborn.PairGrid.html">
   seaborn.PairGrid
  </a>
  <input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" type="checkbox"/>
  <label class="toctree-toggle" for="toctree-checkbox-3">
   <i class="fas fa-chevron-down">
   </i>
  </label>
  <ul>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.__init__.html">
     seaborn.PairGrid.__init__
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.add_legend.html">
     seaborn.PairGrid.add_legend
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.apply.html">
     seaborn.PairGrid.apply
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.map.html">
     seaborn.PairGrid.map
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.map_diag.html">
     seaborn.PairGrid.map_diag
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.map_lower.html">
     seaborn.PairGrid.map_lower
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.map_offdiag.html">
     seaborn.PairGrid.map_offdiag
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.map_upper.html">
     seaborn.PairGrid.map_upper
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.pipe.html">
     seaborn.PairGrid.pipe
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.savefig.html">
     seaborn.PairGrid.savefig
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.set.html">
     seaborn.PairGrid.set
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.tick_params.html">
     seaborn.PairGrid.tick_params
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.PairGrid.tight_layout.html">
     seaborn.PairGrid.tight_layout
    </a>
   </li>
  </ul>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.jointplot.html">
   seaborn.jointplot
  </a>
 </li>
 <li class="toctree-l1 has-children">
  <a class="reference internal" href="seaborn.JointGrid.html">
   seaborn.JointGrid
  </a>
  <input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" type="checkbox"/>
  <label class="toctree-toggle" for="toctree-checkbox-4">
   <i class="fas fa-chevron-down">
   </i>
  </label>
  <ul>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.__init__.html">
     seaborn.JointGrid.__init__
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.apply.html">
     seaborn.JointGrid.apply
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.pipe.html">
     seaborn.JointGrid.pipe
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.plot.html">
     seaborn.JointGrid.plot
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.plot_joint.html">
     seaborn.JointGrid.plot_joint
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.plot_marginals.html">
     seaborn.JointGrid.plot_marginals
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.refline.html">
     seaborn.JointGrid.refline
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.savefig.html">
     seaborn.JointGrid.savefig
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.set.html">
     seaborn.JointGrid.set
    </a>
   </li>
   <li class="toctree-l2">
    <a class="reference internal" href="seaborn.JointGrid.set_axis_labels.html">
     seaborn.JointGrid.set_axis_labels
    </a>
   </li>
  </ul>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set_theme.html">
   seaborn.set_theme
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.axes_style.html">
   seaborn.axes_style
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set_style.html">
   seaborn.set_style
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.plotting_context.html">
   seaborn.plotting_context
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set_context.html">
   seaborn.set_context
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set_color_codes.html">
   seaborn.set_color_codes
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.reset_defaults.html">
   seaborn.reset_defaults
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.reset_orig.html">
   seaborn.reset_orig
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set.html">
   seaborn.set
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set_palette.html">
   seaborn.set_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.color_palette.html">
   seaborn.color_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.husl_palette.html">
   seaborn.husl_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.hls_palette.html">
   seaborn.hls_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.cubehelix_palette.html">
   seaborn.cubehelix_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.dark_palette.html">
   seaborn.dark_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.light_palette.html">
   seaborn.light_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.diverging_palette.html">
   seaborn.diverging_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.blend_palette.html">
   seaborn.blend_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.xkcd_palette.html">
   seaborn.xkcd_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.crayon_palette.html">
   seaborn.crayon_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.mpl_palette.html">
   seaborn.mpl_palette
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.choose_colorbrewer_palette.html">
   seaborn.choose_colorbrewer_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.choose_cubehelix_palette.html">
   seaborn.choose_cubehelix_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.choose_light_palette.html">
   seaborn.choose_light_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.choose_dark_palette.html">
   seaborn.choose_dark_palette
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.choose_diverging_palette.html">
   seaborn.choose_diverging_palette
  </a>
 </li>
</ul>
<ul class="nav bd-sidenav">
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.despine.html">
   seaborn.despine
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.move_legend.html">
   seaborn.move_legend
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.saturate.html">
   seaborn.saturate
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.desaturate.html">
   seaborn.desaturate
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.set_hls_values.html">
   seaborn.set_hls_values
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.load_dataset.html">
   seaborn.load_dataset
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.get_dataset_names.html">
   seaborn.get_dataset_names
  </a>
 </li>
 <li class="toctree-l1">
  <a class="reference internal" href="seaborn.get_data_home.html">
   seaborn.get_data_home
  </a>
 </li>
</ul>

  </div>
</nav>
    </div>
  </div>
  

  
  <div class="sidebar-end-items sidebar-primary__section">
    <div class="sidebar-end-items__item">
    </div>
  </div>

      </div>

      
      
      
        <div class="bd-sidebar-secondary bd-toc">
          
<div class="toc-item">
  
<div class="tocsection onthispage">
    <i class="fas fa-list"></i> On this page
</div>
<nav id="bd-toc-nav" class="page-toc">
    <ul class="visible nav section-nav flex-column">
 <li class="toc-h2 nav-item toc-entry">
  <a class="reference internal nav-link" href="#seaborn.objects.Plot.on">
   <code class="docutils literal notranslate">
    <span class="pre">
     Plot.on()
    </span>
   </code>
  </a>
 </li>
</ul>

</nav>
</div>

<div class="toc-item">
  
</div>

<div class="toc-item">
  
</div>

        </div>
      
      

      
      
      <div class="bd-content col">
          
          <div class="bd-header-article">
              
          </div>

          
          
          <article class="bd-article" role="main">
            
  <section id="seaborn-objects-plot-on">
<h1>seaborn.objects.Plot.on<a class="headerlink" href="#seaborn-objects-plot-on" title="Permalink to this heading">#</a></h1>
<dl class="py method">
<dt class="sig sig-object py" id="seaborn.objects.Plot.on">
<span class="sig-prename descclassname"><span class="pre">Plot.</span></span><span class="sig-name descname"><span class="pre">on</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">target</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#seaborn.objects.Plot.on" title="Permalink to this definition">#</a></dt>
<dd><p>Provide existing Matplotlib figure or axes for drawing the plot.</p>
<p>When using this method, you will also need to explicitly call a method that
triggers compilation, such as <a class="reference internal" href="seaborn.objects.Plot.show.html#seaborn.objects.Plot.show" title="seaborn.objects.Plot.show"><code class="xref py py-meth docutils literal notranslate"><span class="pre">Plot.show()</span></code></a> or <a class="reference internal" href="seaborn.objects.Plot.save.html#seaborn.objects.Plot.save" title="seaborn.objects.Plot.save"><code class="xref py py-meth docutils literal notranslate"><span class="pre">Plot.save()</span></code></a>. If you
want to postprocess using matplotlib, you’d need to call <a class="reference internal" href="seaborn.objects.Plot.plot.html#seaborn.objects.Plot.plot" title="seaborn.objects.Plot.plot"><code class="xref py py-meth docutils literal notranslate"><span class="pre">Plot.plot()</span></code></a>
first to compile the plot without rendering it.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><dl class="simple">
<dt><strong>target</strong><span class="classifier">Axes, SubFigure, or Figure</span></dt><dd><p>Matplotlib object to use. Passing <a class="reference external" href="https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="(in Matplotlib v3.8.2)"><code class="xref py py-class docutils literal notranslate"><span class="pre">matplotlib.axes.Axes</span></code></a> will add
artists without otherwise modifying the figure. Otherwise, subplots will be
created within the space of the given <a class="reference external" href="https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure" title="(in Matplotlib v3.8.2)"><code class="xref py py-class docutils literal notranslate"><span class="pre">matplotlib.figure.Figure</span></code></a> or
<a class="reference external" href="https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.SubFigure" title="(in Matplotlib v3.8.2)"><code class="xref py py-class docutils literal notranslate"><span class="pre">matplotlib.figure.SubFigure</span></code></a>.</p>
</dd>
</dl>
</dd>
</dl>
<p class="rubric">Examples</p>
<p>Passing a <a class="reference external" href="https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes" title="(in Matplotlib v3.8.2)"><code class="xref py py-class docutils literal notranslate"><span class="pre">matplotlib.axes.Axes</span></code></a> object provides functionality closest to seaborn’s axes-level plotting functions. Notice how the resulting image looks different from others created with <a class="reference internal" href="seaborn.objects.Plot.html#seaborn.objects.Plot" title="seaborn.objects.Plot"><code class="xref py py-class docutils literal notranslate"><span class="pre">Plot</span></code></a>. This is because the plot theme uses the global rcParams at the time the axes were created, rather than <a class="reference internal" href="seaborn.objects.Plot.html#seaborn.objects.Plot" title="seaborn.objects.Plot"><code class="xref py py-class docutils literal notranslate"><span class="pre">Plot</span></code></a> defaults:</p>
<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="n">so</span><span class="o">.</span><span class="n">Plot</span><span class="p">(</span><span class="n">diamonds</span><span class="p">,</span> <span class="s2">&quot;carat&quot;</span><span class="p">,</span> <span class="s2">&quot;price&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">so</span><span class="o">.</span><span class="n">Dots</span><span class="p">())</span>
<span class="n">f</span><span class="p">,</span> <span class="n">ax</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">subplots</span><span class="p">()</span>
<span class="n">p</span><span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="n">ax</span><span class="p">)</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
</pre></div>
</div>
<a class="reference internal image-reference" href="../_images/objects.Plot.on_2_0.png"><img alt="../_images/objects.Plot.on_2_0.png" src="../_images/objects.Plot.on_2_0.png" style="width: 513px; height: 379px;" /></a>
<p>Alternatively, calling <a class="reference external" href="https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure" title="(in Matplotlib v3.8.2)"><code class="xref py py-func docutils literal notranslate"><span class="pre">matplotlib.pyplot.figure()</span></code></a> will defer axes creation to <a class="reference internal" href="seaborn.objects.Plot.html#seaborn.objects.Plot" title="seaborn.objects.Plot"><code class="xref py py-class docutils literal notranslate"><span class="pre">Plot</span></code></a>, which will apply the default theme (and any customizations specified with <a class="reference internal" href="seaborn.objects.Plot.theme.html#seaborn.objects.Plot.theme" title="seaborn.objects.Plot.theme"><code class="xref py py-meth docutils literal notranslate"><span class="pre">Plot.theme()</span></code></a>):</p>
<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">f</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">figure</span><span class="p">()</span>
<span class="n">p</span><span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="n">f</span><span class="p">)</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
</pre></div>
</div>
<a class="reference internal image-reference" href="../_images/objects.Plot.on_4_0.png"><img alt="../_images/objects.Plot.on_4_0.png" src="../_images/objects.Plot.on_4_0.png" style="width: 522px; height: 385px;" /></a>
<p>Creating a <a class="reference external" href="https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure" title="(in Matplotlib v3.8.2)"><code class="xref py py-class docutils literal notranslate"><span class="pre">matplotlib.figure.Figure</span></code></a> object will bypass <code class="docutils literal notranslate"><span class="pre">pyplot</span></code> altogether. This may be useful for embedding <a class="reference internal" href="seaborn.objects.Plot.html#seaborn.objects.Plot" title="seaborn.objects.Plot"><code class="xref py py-class docutils literal notranslate"><span class="pre">Plot</span></code></a> figures in a GUI application:</p>
<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">f</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">figure</span><span class="o">.</span><span class="n">Figure</span><span class="p">()</span>
<span class="n">p</span><span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="n">f</span><span class="p">)</span><span class="o">.</span><span class="n">plot</span><span class="p">()</span>
</pre></div>
</div>
<a class="reference internal image-reference" href="../_images/objects.Plot.on_6_0.png"><img alt="../_images/objects.Plot.on_6_0.png" src="../_images/objects.Plot.on_6_0.png" style="width: 483.22499999999997px; height: 357.425px;" /></a>
<p>Using <a class="reference internal" href="#seaborn.objects.Plot.on" title="seaborn.objects.Plot.on"><code class="xref py py-class docutils literal notranslate"><span class="pre">Plot.on</span></code></a> also provides access to the underlying matplotlib objects, which may be useful for deep customization. But it requires a careful attention to the order of operations by which the <a class="reference internal" href="seaborn.objects.Plot.html#seaborn.objects.Plot" title="seaborn.objects.Plot"><code class="xref py py-class docutils literal notranslate"><span class="pre">Plot</span></code></a> is specified, compiled, customized, and displayed:</p>
<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">f</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">figure</span><span class="o">.</span><span class="n">Figure</span><span class="p">()</span>
<span class="n">res</span> <span class="o">=</span> <span class="n">p</span><span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="n">f</span><span class="p">)</span><span class="o">.</span><span class="n">plot</span><span class="p">()</span>

<span class="n">ax</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">axes</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
<span class="n">rect</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">patches</span><span class="o">.</span><span class="n">Rectangle</span><span class="p">(</span>
    <span class="n">xy</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">),</span> <span class="n">width</span><span class="o">=</span><span class="mf">.4</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="mf">.1</span><span class="p">,</span>
    <span class="n">color</span><span class="o">=</span><span class="s2">&quot;C1&quot;</span><span class="p">,</span> <span class="n">alpha</span><span class="o">=</span><span class="mf">.2</span><span class="p">,</span>
    <span class="n">transform</span><span class="o">=</span><span class="n">ax</span><span class="o">.</span><span class="n">transAxes</span><span class="p">,</span> <span class="n">clip_on</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
<span class="p">)</span>
<span class="n">ax</span><span class="o">.</span><span class="n">add_artist</span><span class="p">(</span><span class="n">rect</span><span class="p">)</span>
<span class="n">ax</span><span class="o">.</span><span class="n">text</span><span class="p">(</span>
    <span class="n">x</span><span class="o">=</span><span class="n">rect</span><span class="o">.</span><span class="n">get_width</span><span class="p">()</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="n">y</span><span class="o">=</span><span class="mi">1</span> <span class="o">+</span> <span class="n">rect</span><span class="o">.</span><span class="n">get_height</span><span class="p">()</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span>
    <span class="n">s</span><span class="o">=</span><span class="s2">&quot;Diamonds: very sparkly!&quot;</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="mi">12</span><span class="p">,</span>
    <span class="n">ha</span><span class="o">=</span><span class="s2">&quot;center&quot;</span><span class="p">,</span> <span class="n">va</span><span class="o">=</span><span class="s2">&quot;center&quot;</span><span class="p">,</span> <span class="n">transform</span><span class="o">=</span><span class="n">ax</span><span class="o">.</span><span class="n">transAxes</span><span class="p">,</span>
<span class="p">)</span>

<span class="n">res</span>
</pre></div>
</div>
<a class="reference internal image-reference" href="../_images/objects.Plot.on_8_0.png"><img alt="../_images/objects.Plot.on_8_0.png" src="../_images/objects.Plot.on_8_0.png" style="width: 483.22499999999997px; height: 387.175px;" /></a>
<p>Matplotlib 3.4 introduced the concept of <a class="reference external" href="https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.subfigures" title="(in Matplotlib v3.8.2)"><code class="xref py py-meth docutils literal notranslate"><span class="pre">matplotlib.figure.Figure.subfigures()</span></code></a>, which make it easier to composite multiple arrangements of subplots. These can also be passed to <a class="reference internal" href="#seaborn.objects.Plot.on" title="seaborn.objects.Plot.on"><code class="xref py py-meth docutils literal notranslate"><span class="pre">Plot.on()</span></code></a>,</p>
<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">f</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">figure</span><span class="o">.</span><span class="n">Figure</span><span class="p">(</span><span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">7</span><span class="p">,</span> <span class="mi">4</span><span class="p">),</span> <span class="n">dpi</span><span class="o">=</span><span class="mi">100</span><span class="p">,</span> <span class="n">layout</span><span class="o">=</span><span class="s2">&quot;constrained&quot;</span><span class="p">)</span>
<span class="n">sf1</span><span class="p">,</span> <span class="n">sf2</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">subfigures</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>

<span class="n">p</span><span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="n">sf1</span><span class="p">)</span><span class="o">.</span><span class="n">plot</span><span class="p">()</span>
<span class="p">(</span>
    <span class="n">so</span><span class="o">.</span><span class="n">Plot</span><span class="p">(</span><span class="n">diamonds</span><span class="p">,</span> <span class="n">x</span><span class="o">=</span><span class="s2">&quot;price&quot;</span><span class="p">)</span>
    <span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">so</span><span class="o">.</span><span class="n">Bars</span><span class="p">(),</span> <span class="n">so</span><span class="o">.</span><span class="n">Hist</span><span class="p">())</span>
    <span class="o">.</span><span class="n">facet</span><span class="p">(</span><span class="n">row</span><span class="o">=</span><span class="s2">&quot;cut&quot;</span><span class="p">)</span>
    <span class="o">.</span><span class="n">scale</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="s2">&quot;log&quot;</span><span class="p">)</span>
    <span class="o">.</span><span class="n">share</span><span class="p">(</span><span class="n">y</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
    <span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="n">sf2</span><span class="p">)</span>
<span class="p">)</span>
</pre></div>
</div>
<a class="reference internal image-reference" href="../_images/objects.Plot.on_10_0.png"><img alt="../_images/objects.Plot.on_10_0.png" src="../_images/objects.Plot.on_10_0.png" style="width: 580.55px; height: 335.75px;" /></a>
</dd></dl>

</section>


          </article>
          

          
          
      </div>
      
    </div>
  </div>

  
    
  <!-- Scripts loaded after <body> so the DOM is not blocked -->
  <script src="../_static/scripts/pydata-sphinx-theme.js?digest=9b1a4fa89bdd0e95b23b"></script>

<footer class="footer" style="border-top: 1px solid #ccc; padding-top: 10px">
  <div class="container">
    <div id="credits" style="width: 50%; float: left">
      <p>
      &#169; Copyright 2012-2024, <a href="https://mwaskom.github.io/">Michael Waskom</a>.<br/>
      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> and the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/">PyData Theme</a>.<br/>
      </p>
    </div>
    <div class="dropup show" style="float: right; margin: 10px">
        <a class="btn btn-secondary dropdown-toggle" href="#" role="button" id="dropdownMenuLink" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
            Archive
        </a>
        <div class="dropdown-menu dropdown-menu-right" aria-labelledby="dropdownMenuLink">
          <a class="dropdown-item" href="/archive/0.12/index.html">v0.12</a>
          <a class="dropdown-item" href="/archive/0.11/index.html">v0.11</a>
          <a class="dropdown-item" href="/archive/0.10/index.html">v0.10</a>
          <a class="dropdown-item" href="/archive/0.9/index.html">v0.9</a>
        </div>
    </div>
    <div id="version" style="color: #999; float: right; margin: 15px">v0.13.2</div>
    </div>
  </div>
</footer>
  </body>
</html>