<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="X-UA-Compatible" content="IE=Edge" />

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

<title>How-to and troubleshooting &#8212; Matplotlib 3.5.0 documentation</title>

<link href="../../_static/css/theme.css" rel="stylesheet">

<link href="../../_static/css/index.ff1ffe594081f20da1ef19478df9384b.css" 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/css/style.css" />

<link rel="stylesheet" type="text/css" href="../../_static/graphviz.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/sg_gallery.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-binder.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-dataframe.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-rendered-html.css" />

<link rel="stylesheet" type="text/css" href="../../_static/panels-main.c949a650a448cc0ae9fd3441c0e17fb0.css" />

<link rel="stylesheet" type="text/css" href="../../_static/panels-variables.06eb56fa6e07937060861dad626602ad.css" />

<link rel="stylesheet" type="text/css" href="../../_static/mpl.css?v3.5.0-3-gb7c2e55371" />

<link rel="preload" as="script" href="../../_static/js/index.be7d3bbb2ef33a8344ce.js">

<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/doctools.js"></script>

<script src="../../_static/clipboard.min.js"></script>

<script src="../../_static/copybutton.js"></script>

<link rel="canonical" href="https://matplotlib.org/stable/users/faq/index.html" />

<link rel="search" type="application/opensearchdescription+xml"

title="Search within Matplotlib 3.5.0 documentation"

href="../../_static/opensearch.xml"/>

<link rel="shortcut icon" href="../../_static/favicon.ico"/>

<link rel="search" title="Search" href="../../search.html" />

<link rel="next" title="How-to" href="howto_faq.html" />

<link rel="prev" title="Performance" href="../explain/performance.html" />

<meta name="viewport" content="width=device-width, initial-scale=1" />

<meta name="docsearch:language" content="None">

<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>

</head>

<body data-spy="scroll" data-target="#bd-toc-nav" data-offset="80">

<div class="container-fluid" id="banner"></div>

<nav class="navbar navbar-light navbar-expand-lg bg-light fixed-top bd-navbar" id="navbar-main"><div class="container-xl">

<div id="navbar-start">

<a class="navbar-brand" href="../../index.html">

<img src="../../_static/logo2.svg" class="logo" alt="logo">

</a>

</div>

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-collapsible" aria-controls="navbar-collapsible" aria-expanded="false" aria-label="Toggle navigation">

<span class="navbar-toggler-icon"></span>

</button>

<div id="navbar-collapsible" class="col-lg-9 collapse navbar-collapse">

<div id="navbar-center" class="mr-auto">

<div class="navbar-center-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="../../gallery/index.html">Examples</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="../../api/index.html">Reference</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../index.html">Usage guide</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../devel/index.html">Develop</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../release_notes.html">Release notes</a>

</li>

</div>

</div>

<div id="navbar-end">

<div class="navbar-end-item">

<ul id="navbar-icon-links" class="navbar-nav" aria-label="Icon Links">

<li class="nav-item">

<a class="nav-link" href="https://gitter.im/matplotlib/matplotlib" rel="noopener" target="_blank" title="gitter">

<span><i class="fab fa-gitter"></i></span>

<label class="sr-only">gitter</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://discourse.matplotlib.org" rel="noopener" target="_blank" title="discourse">

<span><i class="fab fa-discourse"></i></span>

<label class="sr-only">discourse</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://github.com/matplotlib/matplotlib" rel="noopener" target="_blank" title="GitHub">

<span><i class="fab fa-github-square"></i></span>

<label class="sr-only">GitHub</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://twitter.com/matplotlib/" rel="noopener" target="_blank" title="twitter">

<span><i class="fab fa-twitter-square"></i></span>

<label class="sr-only">twitter</label>

</a>

</li>

</ul>

</div>

</div>

</div>

</nav>

<div class="container-xl">

<div class="row">

<!-- Only show if we have sidebars configured, else just a small margin -->

<div class="col-12 col-md-3 bd-sidebar"><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" >

</form><nav class="bd-links" id="bd-docs-nav" aria-label="Main navigation">

<div class="bd-toc-item active">

<ul class="nav bd-sidenav">

<li class="toctree-l1">

<a class="reference internal" href="howto_faq.html">

How-to

</a>

</li>

<li class="toctree-l1">

<a class="reference internal" href="troubleshooting_faq.html">

Troubleshooting

</a>

</li>

<li class="toctree-l1">

<a class="reference internal" href="environment_variables_faq.html">

Environment variables

</a>

</li>

</div>

</div>

<div class="d-none d-xl-block col-xl-2 bd-toc">

<div class="toc-item">

<nav id="bd-toc-nav">

</div>

<div class="toc-item">

</div>

</div>

<main class="col-12 col-md-9 col-xl-7 py-md-5 pl-md-5 pr-md-4 bd-content" role="main">

<div>

<section id="how-to-and-troubleshooting">

<span id="faq-index"></span><h1>How-to and troubleshooting<a class="headerlink" href="#how-to-and-troubleshooting" title="Permalink to this headline">¶</a></h1>

<dl class="field-list simple">

<dt class="field-odd">Release</dt>

<dd class="field-odd"><p>3.5.0</p>

<dt class="field-even">Date</dt>

<dd class="field-even"><p>November 16, 2021</p>

<p>Frequently asked questions about Matplotlib:</p>

<div class="toctree-wrapper compound">

<li class="toctree-l1"><a class="reference internal" href="howto_faq.html">How-to</a><ul>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#check-whether-a-figure-is-empty">Check whether a figure is empty</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#find-all-objects-in-a-figure-of-a-certain-type">Find all objects in a figure of a certain type</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#prevent-ticklabels-from-having-an-offset">Prevent ticklabels from having an offset</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#save-transparent-figures">Save transparent figures</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#save-multiple-plots-to-one-pdf-file">Save multiple plots to one pdf file</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#make-room-for-tick-labels">Make room for tick labels</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#align-my-ylabels-across-multiple-subplots">Align my ylabels across multiple subplots</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#control-the-draw-order-of-plot-elements">Control the draw order of plot elements</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#make-the-aspect-ratio-for-plots-equal">Make the aspect ratio for plots equal</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#draw-multiple-y-axis-scales">Draw multiple y-axis scales</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#generate-images-without-having-a-window-appear">Generate images without having a window appear</a></li>

<li class="toctree-l2"><a class="reference internal" href="howto_faq.html#work-with-threads">Work with threads</a></li>

<li class="toctree-l1"><a class="reference internal" href="troubleshooting_faq.html">Troubleshooting</a><ul>

<li class="toctree-l2"><a class="reference internal" href="troubleshooting_faq.html#obtaining-matplotlib-version">Obtaining Matplotlib version</a></li>

<li class="toctree-l2"><a class="reference internal" href="troubleshooting_faq.html#matplotlib-install-location"><code class="file docutils literal notranslate"><span class="pre">matplotlib</span></code> install location</a></li>

<li class="toctree-l2"><a class="reference internal" href="troubleshooting_faq.html#matplotlib-configuration-and-cache-directory-locations"><code class="file docutils literal notranslate"><span class="pre">matplotlib</span></code> configuration and cache directory locations</a></li>

<li class="toctree-l2"><a class="reference internal" href="troubleshooting_faq.html#getting-help">Getting help</a></li>

<li class="toctree-l2"><a class="reference internal" href="troubleshooting_faq.html#problems-with-recent-git-versions">Problems with recent git versions</a></li>

<li class="toctree-l1"><a class="reference internal" href="environment_variables_faq.html">Environment variables</a><ul>

<li class="toctree-l2"><a class="reference internal" href="environment_variables_faq.html#setting-environment-variables-in-linux-and-macos">Setting environment variables in Linux and macOS</a></li>

<li class="toctree-l2"><a class="reference internal" href="environment_variables_faq.html#setting-environment-variables-in-windows">Setting environment variables in Windows</a></li>

</div>

</main>

</div>

</div>

<script src="../../_static/js/index.be7d3bbb2ef33a8344ce.js"></script>

<footer class="footer mt-5 mt-md-0">

<div class="container">

<div class="footer-item">

<p class="copyright">

&copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2021 The Matplotlib development team.<br>

</div>

<div class="footer-item">

<p class="sphinx-version">

Created using <a href="http://sphinx-doc.org/">Sphinx</a> 4.3.0.<br>

</div>

</div>

</body>