
.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "gallery/ticks/colorbar_tick_labelling_demo.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_ticks_colorbar_tick_labelling_demo.py>`
        to download the full example code.

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

.. _sphx_glr_gallery_ticks_colorbar_tick_labelling_demo.py:


=======================
Colorbar Tick Labelling
=======================

Vertical colorbars have ticks, tick labels, and labels visible on the *y* axis,
horizontal colorbars on the *x* axis. The ``ticks`` parameter can be used to
set the ticks and the ``format`` parameter can be used to format the tick labels
of the visible colorbar Axes. For further adjustments, the ``yaxis`` or
``xaxis`` Axes of the colorbar can be retrieved using its ``ax`` property.

.. GENERATED FROM PYTHON SOURCE LINES 12-20

.. code-block:: Python

    import matplotlib.pyplot as plt
    import numpy as np

    import matplotlib.ticker as mticker

    # Fixing random state for reproducibility
    rng = np.random.default_rng(seed=19680801)








.. GENERATED FROM PYTHON SOURCE LINES 21-22

Make plot with vertical (default) colorbar

.. GENERATED FROM PYTHON SOURCE LINES 22-40

.. code-block:: Python


    fig, ax = plt.subplots()

    data = rng.standard_normal((250, 250))

    cax = ax.imshow(data, vmin=-1, vmax=1, cmap='coolwarm')
    ax.set_title('Gaussian noise with vertical colorbar')

    # Add colorbar, make sure to specify tick locations to match desired ticklabels
    cbar = fig.colorbar(cax,
                        ticks=[-1, 0, 1],
                        format=mticker.FixedFormatter(['< -1', '0', '> 1']),
                        extend='both'
                        )
    labels = cbar.ax.get_yticklabels()
    labels[0].set_verticalalignment('top')
    labels[-1].set_verticalalignment('bottom')




.. image-sg:: /gallery/ticks/images/sphx_glr_colorbar_tick_labelling_demo_001.png
   :alt: Gaussian noise with vertical colorbar
   :srcset: /gallery/ticks/images/sphx_glr_colorbar_tick_labelling_demo_001.png, /gallery/ticks/images/sphx_glr_colorbar_tick_labelling_demo_001_2_00x.png 2.00x
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 41-42

Make plot with horizontal colorbar

.. GENERATED FROM PYTHON SOURCE LINES 42-56

.. code-block:: Python


    fig, ax = plt.subplots()

    data = np.clip(data, -1, 1)

    cax = ax.imshow(data, cmap='afmhot')
    ax.set_title('Gaussian noise with horizontal colorbar')

    # Add colorbar and adjust ticks afterwards
    cbar = fig.colorbar(cax, orientation='horizontal')
    cbar.set_ticks(ticks=[-1, 0, 1], labels=['Low', 'Medium', 'High'])

    plt.show()




.. image-sg:: /gallery/ticks/images/sphx_glr_colorbar_tick_labelling_demo_002.png
   :alt: Gaussian noise with horizontal colorbar
   :srcset: /gallery/ticks/images/sphx_glr_colorbar_tick_labelling_demo_002.png, /gallery/ticks/images/sphx_glr_colorbar_tick_labelling_demo_002_2_00x.png 2.00x
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 57-64

.. admonition:: References

   The use of the following functions, methods, classes and modules is shown
   in this example:

   - `matplotlib.colorbar.Colorbar.set_ticks`
   - `matplotlib.figure.Figure.colorbar` / `matplotlib.pyplot.colorbar`


.. _sphx_glr_download_gallery_ticks_colorbar_tick_labelling_demo.py:

.. only:: html

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

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

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

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

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

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: colorbar_tick_labelling_demo.zip <colorbar_tick_labelling_demo.zip>`


.. only:: html

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

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