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

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

.. _sphx_glr_auto_examples_Markers_plot_transform_markers.py:


Coordinate transforms — pin markers to the axes or the screen
=============================================================

Every ``add_*`` marker method takes a ``transform`` that decides which
coordinate system its positions live in:

- ``"data"`` (default) — data coordinates; the marker moves and scales with
  zoom / pan, staying glued to the underlying data.
- ``"axes"`` — axes-normalised ``(0, 0)`` bottom-left … ``(1, 1)`` top-right;
  the marker stays in the same corner of the panel no matter how you zoom.
- ``"display"`` — raw CSS pixels within the panel; a fixed-size decoration.

The ``"axes"`` and ``"display"`` transforms are how you build overlays that
should *not* track the data — a navigation index in the corner, a scale bar, a
persistent legend chip.

.. GENERATED FROM PYTHON SOURCE LINES 18-40

.. code-block:: Python

    import numpy as np
    import anyplotlib as apl

    rng  = np.random.default_rng(1)
    data = rng.standard_normal((128, 128)).cumsum(0).cumsum(1)
    data = (data - data.min()) / (data.max() - data.min())
    xy   = np.linspace(0, 10, 128)

    fig, ax = apl.subplots(1, 1, figsize=(480, 480))
    v = ax.imshow(data, axes=[xy, xy], units="nm")

    # Data-anchored label — sits at (5, 5) in nm and rides along on zoom/pan.
    v.add_texts(offsets=[(5, 5)], texts=["feature @ (5, 5)"],
                color="#ffffff", fontsize=12, name="data_label")

    # Axes-anchored index — stays pinned to the top-left corner of the panel
    # regardless of zoom (0, 1 = top-left in axes fractions).
    v.add_texts(offsets=[(0.04, 0.96)], texts=["frame 3 / 20"],
                transform="axes", color="#ffd54f", fontsize=13, name="nav_index")

    fig





.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_transform_markers_001" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_transform_markers_001" style="display:inline-block;overflow:hidden;position:relative;width:496px;height:496px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_transform_markers_001.html" data-awi-fig="sphx_glr_plot_transform_markers_001" frameborder="0" scrolling="no" style="width:496px;height:496px;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_transform_markers_001'),ifr=wrap.querySelector('iframe'),nw=496,nh=496;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 41-46

Try it
------
Zoom into the image: the white ``feature`` label moves with the data, while
the yellow ``frame 3 / 20`` index stays locked to the corner — because it is
positioned in ``"axes"`` coordinates.

.. GENERATED FROM PYTHON SOURCE LINES 46-50

.. code-block:: Python


    fig.set_help("Zoom in: the corner index stays put; the data label moves.")

    fig  # Interactive




.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_transform_markers_002" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_transform_markers_002" style="display:inline-block;overflow:hidden;position:relative;width:496px;height:496px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_transform_markers_002.html" data-awi-fig="sphx_glr_plot_transform_markers_002" frameborder="0" scrolling="no" style="width:496px;height:496px;border:none;overflow:hidden;display:block;transform-origin:top left;transform:scale(1);position:absolute;top:0;left:0;"></iframe><div class="awi-badge" data-awi-badge="sphx_glr_plot_transform_markers_002"><button class="awi-badge-icon awi-activate-btn" data-awi-fig="sphx_glr_plot_transform_markers_002" title="Make interactive (boots Pyodide — may take ~10 s)">&#x26A1;</button></div></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_transform_markers_002'),ifr=wrap.querySelector('iframe'),nw=496,nh=496;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>



.. raw:: html

    <script type="text/x-python" data-fig-id="sphx_glr_plot_transform_markers_002" data-fig-index="1" data-src-file="plot_transform_markers" data-src="&quot;\&quot;\&quot;\&quot;\nCoordinate transforms \u2014 pin markers to the axes or the screen\n=============================================================\n\nEvery ``add_*`` marker method takes a ``transform`` that decides which\ncoordinate system its positions live in:\n\n- ``\&quot;data\&quot;`` (default) \u2014 data coordinates; the marker moves and scales with\n  zoom / pan, staying glued to the underlying data.\n- ``\&quot;axes\&quot;`` \u2014 axes-normalised ``(0, 0)`` bottom-left \u2026 ``(1, 1)`` top-right;\n  the marker stays in the same corner of the panel no matter how you zoom.\n- ``\&quot;display\&quot;`` \u2014 raw CSS pixels within the panel; a fixed-size decoration.\n\nThe ``\&quot;axes\&quot;`` and ``\&quot;display\&quot;`` transforms are how you build overlays that\nshould *not* track the data \u2014 a navigation index in the corner, a scale bar, a\npersistent legend chip.\n\&quot;\&quot;\&quot;\nimport numpy as np\nimport anyplotlib as apl\n\nrng  = np.random.default_rng(1)\ndata = rng.standard_normal((128, 128)).cumsum(0).cumsum(1)\ndata = (data - data.min()) / (data.max() - data.min())\nxy   = np.linspace(0, 10, 128)\n\nfig, ax = apl.subplots(1, 1, figsize=(480, 480))\nv = ax.imshow(data, axes=[xy, xy], units=\&quot;nm\&quot;)\n\n# Data-anchored label \u2014 sits at (5, 5) in nm and rides along on zoom/pan.\nv.add_texts(offsets=[(5, 5)], texts=[\&quot;feature @ (5, 5)\&quot;],\n            color=\&quot;#ffffff\&quot;, fontsize=12, name=\&quot;data_label\&quot;)\n\n# Axes-anchored index \u2014 stays pinned to the top-left corner of the panel\n# regardless of zoom (0, 1 = top-left in axes fractions).\nv.add_texts(offsets=[(0.04, 0.96)], texts=[\&quot;frame 3 / 20\&quot;],\n            transform=\&quot;axes\&quot;, color=\&quot;#ffd54f\&quot;, fontsize=13, name=\&quot;nav_index\&quot;)\n\nfig\n\n# %%\n# Try it\n# ------\n# Zoom into the image: the white ``feature`` label moves with the data, while\n# the yellow ``frame 3 / 20`` index stays locked to the corner \u2014 because it is\n# positioned in ``\&quot;axes\&quot;`` coordinates.\n\nfig.set_help(\&quot;Zoom in: the corner index stays put; the data label moves.\&quot;)\n\nfig  # Interactive\n&quot;"></script>







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

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


.. _sphx_glr_download_auto_examples_Markers_plot_transform_markers.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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