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

.. only:: html

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

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

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

.. _sphx_glr_auto_examples_Markers_plot_fonts_and_labels.py:


Fonts and Labels
================

All text in anyplotlib — titles, axis labels, the colorbar label and
``texts`` markers — is drawn straight onto the canvas.  Sizes are CSS
pixels, and strings may use a small TeX subset inside ``$...$``.

This example walks through the options for text markers added with
:meth:`~anyplotlib.plot2d.Plot2D.add_texts`: size, weight, outline,
rotation, anchor alignment and math, plus the panel's own labels.

.. GENERATED FROM PYTHON SOURCE LINES 13-33

.. code-block:: Python

    import numpy as np
    import anyplotlib as apl

    rng = np.random.default_rng(11)
    # A busy, non-square image: 180 rows x 260 columns.
    data = rng.standard_normal((180, 260)).cumsum(0).cumsum(1)
    data = (data - data.min()) / np.ptp(data)
    # Calibrated axes so the panel shows ticks and axis labels.  Marker offsets
    # below stay in image pixels (column, row).
    x_nm = np.arange(260) * 0.05
    y_nm = np.arange(180) * 0.05


    def panel(title):
        fig, ax = apl.subplots(1, 1, figsize=(560, 420))
        plot = ax.imshow(data, axes=[x_nm, y_nm], units="nm", cmap="gray")
        plot.set_title(title, fontsize=14)
        return fig, plot









.. GENERATED FROM PYTHON SOURCE LINES 34-38

Panel labels
------------
Titles, axis labels and the colorbar label take an optional ``fontsize``
and the same ``$...$`` markup as text markers.

.. GENERATED FROM PYTHON SOURCE LINES 38-47

.. code-block:: Python


    fig, v = panel(r"Panel labels: $\lambda$ = 2.5 $\AA$")
    v.set_xlabel(r"$x$ (nm)", fontsize=13)
    v.set_ylabel(r"$y$ (nm)", fontsize=13)
    v.set_colorbar_visible(True)
    v.set_colorbar_label(r"Intensity ($\times 10^{3}$)", fontsize=11)
    v.set_tick_label_size(11)
    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_001" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_001" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_001.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_001" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_001'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 48-52

Size and weight
---------------
``fontsize`` and ``fontweight`` apply to the whole group, so labels that
differ in either go in separate groups.

.. GENERATED FROM PYTHON SOURCE LINES 52-61

.. code-block:: Python


    fig, v = panel("Size and weight")
    for i, (size, weight) in enumerate([(12, "normal"), (16, "normal"),
                                        (16, "bold"), (24, "bold")]):
        v.add_texts([[12, 20 + 38 * i]], [f"{size} px {weight}"],
                    name=f"size{i}", color="#ffeb3b",
                    fontsize=size, fontweight=weight)
    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_002" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_002" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_002.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_002" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_002'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 62-67

Outline for legibility
----------------------
Over a busy image a label can vanish into the background.  An
``outline_color`` strokes a halo under the fill; ``outline_width`` sets
its thickness in pixels.

.. GENERATED FROM PYTHON SOURCE LINES 67-76

.. code-block:: Python


    fig, v = panel("Outline (halo)")
    v.add_texts([[12, 40]], ["no outline"], name="plain",
                color="#ffffff", fontsize=20, fontweight="bold")
    v.add_texts([[12, 100]], ["outline_color='black'"], name="halo",
                color="#ffffff", fontsize=20, fontweight="bold",
                outline_color="#000000", outline_width=4)
    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_003" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_003" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_003.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_003" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_003'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 77-81

Rotation
--------
``rotation`` is in **radians** (matplotlib's ``TextCollection``
convention) and turns the label counter-clockwise about its anchor point.

.. GENERATED FROM PYTHON SOURCE LINES 81-94

.. code-block:: Python


    fig, v = panel("Rotation about the anchor")
    anchor = [40, 165]
    v.add_points([anchor], name="anchor", sizes=4, color="#ff1744",
                 facecolors="#ff1744")
    for deg in (0, 45, 90):
        # Leading spaces push the text off the anchor dot.
        v.add_texts([anchor], [f"   rotation = {deg}\N{DEGREE SIGN}"],
                    name=f"rot{deg}", color="#00e5ff", fontsize=16,
                    outline_color="#000000", rotation=np.deg2rad(deg),
                    verticalalignment="center")
    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_004" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_004" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_004.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_004" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_004'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 95-101

Alignment
---------
``horizontalalignment`` (``"left"``, ``"center"``, ``"right"``) and
``verticalalignment`` (``"top"``, ``"center"``, ``"bottom"``,
``"baseline"``) choose which point of the text sits on the anchor.  The
defaults, ``"left"`` and ``"top"``, hang the label below and to the right.

.. GENERATED FROM PYTHON SOURCE LINES 101-114

.. code-block:: Python


    fig, v = panel("horizontal / vertical alignment")
    cols = {"left": 45, "center": 130, "right": 215}
    rows = {"top": 40, "center": 90, "bottom": 140}
    for ha, x in cols.items():
        for va, y in rows.items():
            v.add_points([[x, y]], name=f"pt-{ha}-{va}", sizes=3,
                         color="#ff1744", facecolors="#ff1744")
            v.add_texts([[x, y]], [f"{ha}/{va}"], name=f"txt-{ha}-{va}",
                        color="#ffeb3b", fontsize=13, outline_color="#000000",
                        horizontalalignment=ha, verticalalignment=va)
    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_005" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_005" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_005.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_005" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_005'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 115-121

Math in labels
--------------
Text with an even number of ``$`` signs is typeset: superscripts,
subscripts, Greek letters and ``\mathrm{}`` for upright text.  Weight and
outline still apply.  As in matplotlib, a string with a single (odd)
``$`` is plain text, so prices and shell prompts draw as written.

.. GENERATED FROM PYTHON SOURCE LINES 121-135

.. code-block:: Python


    fig, v = panel("TeX in text markers")
    v.add_texts([[12, 25]], [r"$\mathrm{Fe} K_{\alpha}$ edge"], name="edge",
                color="#ffeb3b", fontsize=18, outline_color="#000000")
    v.add_texts([[12, 65]], [r"$\sigma$ = $10^{-3}$ nm$^{-1}$"],
                name="sigma", color="#ffeb3b", fontsize=18, fontweight="bold",
                outline_color="#000000")
    v.add_texts([[12, 105]], [r"$\Delta E \approx$ 1.2 eV"],
                name="delta", color="#00e5ff", fontsize=18,
                outline_color="#000000")
    v.add_texts([[12, 145]], ["Plain text: $5 each"], name="plain",
                color="#ffffff", fontsize=16, outline_color="#000000")
    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_006" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_006" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_006.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_006" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_006'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>






.. GENERATED FROM PYTHON SOURCE LINES 136-139

Live update
-----------
Every option can change after the label is drawn with ``set(...)``.

.. GENERATED FROM PYTHON SOURCE LINES 139-143

.. code-block:: Python


    v.markers["texts"]["edge"].set(fontsize=22, fontweight="bold",
                                   rotation=np.deg2rad(-8))
    fig




.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_fonts_and_labels_007" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_fonts_and_labels_007" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:436px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_fonts_and_labels_007.html" data-awi-fig="sphx_glr_plot_fonts_and_labels_007" frameborder="0" scrolling="no" style="width:576px;height:436px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_fonts_and_labels_007'),ifr=wrap.querySelector('iframe'),nw=576,nh=436;function r(){var avail=wrap.parentElement?wrap.parentElement.offsetWidth:0;if(!avail)return;var s=Math.min(1,avail/nw);wrap.style.width=Math.round(nw*s)+'px';wrap.style.height=Math.round(nh*s)+'px';ifr.style.transform='scale('+s+')';}requestAnimationFrame(r);window.addEventListener('resize',r);})()</script></div>







.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 4.379 seconds)


.. _sphx_glr_download_auto_examples_Markers_plot_fonts_and_labels.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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