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

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

.. _sphx_glr_auto_examples_Widgets_plot_widget2d_arrow.py:


2D Arrow Widget
===============

A draggable arrow overlay on a 2-D image panel.  The tail sits at ``(x, y)``
and the head at ``(x + u, y + v)`` in data coordinates.  Drag the body to move
the whole arrow; drag the head handle to re-aim it (updating ``u`` / ``v``).
Add it with :meth:`~anyplotlib.Plot2D.add_arrow_widget`.

.. GENERATED FROM PYTHON SOURCE LINES 10-26

.. code-block:: Python

    import numpy as np
    import anyplotlib as apl

    rng  = np.random.default_rng(3)
    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=(460, 460))
    v = ax.imshow(data, axes=[xy, xy], units="nm")

    arrow = v.add_arrow_widget(x=2.0, y=2.0, u=5.0, v=4.0,
                               color="#ff1744", linewidth=2)

    fig





.. raw:: html

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

React to drags
--------------
Register a ``pointer_move`` handler to read the live geometry while the arrow
is dragged or re-aimed (there is no ``on_changed`` method — the event system
is the API).  Read ``arrow.x/y/u/v`` inside the handler.

.. GENERATED FROM PYTHON SOURCE LINES 32-42

.. code-block:: Python



    @arrow.add_event_handler("pointer_move")
    def _report(event):
        print(f"tail=({arrow.x:.1f}, {arrow.y:.1f})  vector=({arrow.u:.1f}, {arrow.v:.1f})")


    fig.set_help("Drag the arrow body to move it; drag the head to re-aim it.")

    fig  # Interactive




.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_widget2d_arrow_002" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_widget2d_arrow_002" style="display:inline-block;overflow:hidden;position:relative;width:476px;height:476px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_widget2d_arrow_002.html" data-awi-fig="sphx_glr_plot_widget2d_arrow_002" frameborder="0" scrolling="no" style="width:476px;height:476px;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_widget2d_arrow_002"><button class="awi-badge-icon awi-activate-btn" data-awi-fig="sphx_glr_plot_widget2d_arrow_002" title="Make interactive (boots Pyodide — may take ~10 s)">&#x26A1;</button></div></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_widget2d_arrow_002'),ifr=wrap.querySelector('iframe'),nw=476,nh=476;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_widget2d_arrow_002" data-fig-index="1" data-src-file="plot_widget2d_arrow" data-src="&quot;\&quot;\&quot;\&quot;\n2D Arrow Widget\n===============\n\nA draggable arrow overlay on a 2-D image panel.  The tail sits at ``(x, y)``\nand the head at ``(x + u, y + v)`` in data coordinates.  Drag the body to move\nthe whole arrow; drag the head handle to re-aim it (updating ``u`` / ``v``).\nAdd it with :meth:`~anyplotlib.Plot2D.add_arrow_widget`.\n\&quot;\&quot;\&quot;\nimport numpy as np\nimport anyplotlib as apl\n\nrng  = np.random.default_rng(3)\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=(460, 460))\nv = ax.imshow(data, axes=[xy, xy], units=\&quot;nm\&quot;)\n\narrow = v.add_arrow_widget(x=2.0, y=2.0, u=5.0, v=4.0,\n                           color=\&quot;#ff1744\&quot;, linewidth=2)\n\nfig\n\n# %%\n# React to drags\n# --------------\n# Register a ``pointer_move`` handler to read the live geometry while the arrow\n# is dragged or re-aimed (there is no ``on_changed`` method \u2014 the event system\n# is the API).  Read ``arrow.x/y/u/v`` inside the handler.\n\n\n@arrow.add_event_handler(\&quot;pointer_move\&quot;)\ndef _report(event):\n    print(f\&quot;tail=({arrow.x:.1f}, {arrow.y:.1f})  vector=({arrow.u:.1f}, {arrow.v:.1f})\&quot;)\n\n\nfig.set_help(\&quot;Drag the arrow body to move it; drag the head to re-aim it.\&quot;)\n\nfig  # Interactive\n&quot;"></script>







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

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


.. _sphx_glr_download_auto_examples_Widgets_plot_widget2d_arrow.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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