.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "gallery/units/units_sample.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. meta::
        :keywords: codex

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_gallery_units_units_sample.py>`
        to download the full example code

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_gallery_units_units_sample.py:


======================
Inches and Centimeters
======================

The example illustrates the ability to override default x and y units (ax1) to
inches and centimeters using the *xunits* and *yunits* parameters for the
`~.axes.Axes.plot` function. Note that conversions are applied to get numbers
to correct units.

.. only:: builder_html

   This example requires :download:`basic_units.py <basic_units.py>`

.. GENERATED FROM PYTHON SOURCE LINES 16-36



.. image-sg:: /gallery/units/images/sphx_glr_units_sample_001.png
   :alt: units sample
   :srcset: /gallery/units/images/sphx_glr_units_sample_001.png, /gallery/units/images/sphx_glr_units_sample_001_2_00x.png 2.00x
   :class: sphx-glr-single-img





.. code-block:: Python

    from basic_units import cm, inch

    import matplotlib.pyplot as plt
    import numpy as np

    cms = cm * np.arange(0, 10, 2)

    fig, axs = plt.subplots(2, 2, layout='constrained')

    axs[0, 0].plot(cms, cms)

    axs[0, 1].plot(cms, cms, xunits=cm, yunits=inch)

    axs[1, 0].plot(cms, cms, xunits=inch, yunits=cm)
    axs[1, 0].set_xlim(-1, 4)  # scalars are interpreted in current units

    axs[1, 1].plot(cms, cms, xunits=inch, yunits=inch)
    axs[1, 1].set_xlim(3*cm, 6*cm)  # cm are converted to inches

    plt.show()


.. _sphx_glr_download_gallery_units_units_sample.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: units_sample.ipynb <units_sample.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: units_sample.py <units_sample.py>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_