<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" />

<title>Inches and Centimeters &#8212; Matplotlib 3.2.0 documentation</title>

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

<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />

<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />

<link rel="stylesheet" type="text/css" href="../../_static/gallery.css" />

<link rel="stylesheet" type="text/css" href="../../_static/copybutton.css" />

<script id="documentation_options" data-url_root="../../" 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/language_data.js"></script>

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

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

<script >var copybuttonSkipText = '>>> ';</script>

<script async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>

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

title="Search within Matplotlib 3.2.0 documentation"

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

<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="top" title="Matplotlib 3.2.0 documentation" href="#" />

<link rel="canonical" href="https://matplotlib.org/stable/gallery/units/units_sample.html" />

<link rel="stylesheet" href="../../_static/custom.css" type="text/css" />

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

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

</head><body>

<div id="unreleased-message"> You are reading an old version of the documentation (v3.2.0). For the latest version see <a href="https://matplotlib.org/stable/gallery/units/units_sample.html">https://matplotlib.org/stable/gallery/units/units_sample.html</a></div>

<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px; position: relative;">

<a href="../../index.html">

<div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px"><span style="float: right; color: #789; background: white">Version 3.2.0</span></div>

<img src="../../_static/logo2_compressed.svg" height="125px" border="0" alt="matplotlib"/></a>

<!-- The "Fork me on github" ribbon -->

<div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div>

</div>

<nav class="main-nav">

<ul>

<li><a href="../../users/installing.html">Installation</a></li>

<li><a href="../../contents.html">Documentation</a></li>

<li><a href="../index.html">Examples</a></li>

<li><a href="../../tutorials/index.html">Tutorials</a></li>

<li><a href="../../devel/index.html">Contributing</a></li>

<li class="nav-right">

<form class="search" action="../../search.html" method="get">

<input type="text" name="q" aria-labelledby="searchlabel" placeholder="Search"/>

</form>

</li>

</ul>

</nav>

<div class="related" role="navigation" aria-label="related navigation">

<h3>Navigation</h3>

<ul>

<li class="right" style="margin-right: 10px">

<a href="../../genindex.html" title="General Index"

accesskey="I">index</a></li>

<li class="right" >

<a href="../../py-modindex.html" title="Python Module Index"

>modules</a> |</li>

<li><a href="../../index.html">home</a>|&nbsp;</li>

<li><a href="../../contents.html">contents</a> &raquo;</li>

</ul>

</div>

<div class="sphinxsidebar" role="navigation" aria-label="main navigation">

<div class="sphinxsidebarwrapper"><div class="relations">

<h3>Related Topics</h3>

<li><a href="../../contents.html">Documentation overview</a><ul>

</ul></li>

<div id="sidebar-pagesource" role="note" aria-label="source link"

style="margin-top: 1.5em; padding-top: 0.1em; border-top: 1px solid #86989b">

<a href="../../_sources/gallery/units/units_sample.rst.txt"

style="color: #c0c0c0" rel="nofollow">Show Page Source</a>

</div>

</div>

</div>

<div class="document">

<div class="documentwrapper">

<div class="bodywrapper">

<div class="body" role="main">

<div class="sphx-glr-download-link-note admonition note">

<p class="first admonition-title">Note</p>

<p class="last">Click <a class="reference internal" href="#sphx-glr-download-gallery-units-units-sample-py"><span class="std std-ref">here</span></a> to download the full example code</p>

<div class="sphx-glr-example-title section" id="inches-and-centimeters">

<span id="sphx-glr-gallery-units-units-sample-py"></span><h1>Inches and Centimeters<a class="headerlink" href="#inches-and-centimeters" title="Permalink to this headline">¶</a></h1>

<p>The example illustrates the ability to override default x and y units (ax1) to

inches and centimeters using the <em>xunits</em> and <em>yunits</em> parameters for the

<a class="reference internal" href="../../api/_as_gen/matplotlib.axes.Axes.plot.html#matplotlib.axes.Axes.plot" title="matplotlib.axes.Axes.plot"><code class="xref py py-obj docutils literal notranslate"><span class="pre">plot</span></code></a> function. Note that conversions are applied to get numbers

to correct units.</p>

<p>This example requires <a class="reference download internal" download="" href="../../_downloads/0f0fd288c7d4a6a16f4835b96343f597/basic_units.py"><code class="xref download docutils literal notranslate"><span class="pre">basic_units.py</span></code></a></p>

<img alt="../../_images/sphx_glr_units_sample_001.png" class="sphx-glr-single-img" src="../../_images/sphx_glr_units_sample_001.png" />

<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">basic_units</span> <span class="kn">import</span> <span class="n">cm</span><span class="p">,</span> <span class="n">inch</span>

<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>

<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>

<span class="n">cms</span> <span class="o">=</span> <span class="n">cm</span> <span class="o">*</span> <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.arange.html#numpy.arange" title="View documentation for numpy.arange"><span class="n">np</span><span class="o">.</span><span class="n">arange</span></a><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>

<a href="../../api/_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="View documentation for matplotlib.figure.Figure"><span class="n">fig</span></a><span class="p">,</span> <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.pyplot.subplots.html#matplotlib.pyplot.subplots" title="View documentation for matplotlib.pyplot.subplots"><span class="n">plt</span><span class="o">.</span><span class="n">subplots</span></a><span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a><span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">cms</span><span class="p">,</span> <span class="n">cms</span><span class="p">)</span>

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a><span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">cms</span><span class="p">,</span> <span class="n">cms</span><span class="p">,</span> <span class="n">xunits</span><span class="o">=</span><span class="n">cm</span><span class="p">,</span> <span class="n">yunits</span><span class="o">=</span><span class="n">inch</span><span class="p">)</span>

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">cms</span><span class="p">,</span> <span class="n">cms</span><span class="p">,</span> <span class="n">xunits</span><span class="o">=</span><span class="n">inch</span><span class="p">,</span> <span class="n">yunits</span><span class="o">=</span><span class="n">cm</span><span class="p">)</span>

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">set_xlim</span><span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mi">6</span><span class="p">)</span> <span class="c1"># scalars are interpreted in current units</span>

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">cms</span><span class="p">,</span> <span class="n">cms</span><span class="p">,</span> <span class="n">xunits</span><span class="o">=</span><span class="n">inch</span><span class="p">,</span> <span class="n">yunits</span><span class="o">=</span><span class="n">inch</span><span class="p">)</span>

<a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><span class="n">axs</span></a><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">set_xlim</span><span class="p">(</span><span class="mi">3</span><span class="o">*</span><span class="n">cm</span><span class="p">,</span> <span class="mi">6</span><span class="o">*</span><span class="n">cm</span><span class="p">)</span> <span class="c1"># cm are converted to inches</span>

<a href="../../api/_as_gen/matplotlib.pyplot.show.html#matplotlib.pyplot.show" title="View documentation for matplotlib.pyplot.show"><span class="n">plt</span><span class="o">.</span><span class="n">show</span></a><span class="p">()</span>

<div class="sphx-glr-footer class sphx-glr-footer-example docutils container" id="sphx-glr-download-gallery-units-units-sample-py">

<div class="sphx-glr-download docutils container">

<a class="reference download internal" download="" href="../../_downloads/1706c3507893617b0b3a6c9e42935299/units_sample.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">units_sample.py</span></code></a></div>

<div class="sphx-glr-download docutils container">

<a class="reference download internal" download="" href="../../_downloads/09c73b5bab901badc89f8ffc49eeab83/units_sample.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">units_sample.ipynb</span></code></a></div>

<p class="sphx-glr-signature">Keywords: matplotlib code example, codex, python plot, pyplot

<a class="reference external" href="https://sphinx-gallery.readthedocs.io">Gallery generated by Sphinx-Gallery</a></p>

</div>

</div>

</div>

<div class="clearer"></div>

</div>

<div class="footer">

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

<br />

Last updated on Mar 04, 2020.

Created using

<a href="http://sphinx-doc.org/">Sphinx</a> 2.4.3.

Doc version v3.2.0-3-gea62ccde8.

</div>

</body>