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

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

.. _sphx_glr_auto_examples_Widgets_plot_widget1d_point.py:


1D Point Widget
===============

A free-moving ``(x, y)`` control point on a 1-D panel, with an optional
crosshair.  Unlike the vertical / horizontal line widgets it moves in both
directions, so it is handy as a draggable data cursor or a control handle for
an interactive fit.  Add it with :meth:`~anyplotlib.Plot1D.add_point_widget`.

.. GENERATED FROM PYTHON SOURCE LINES 10-24

.. code-block:: Python

    import numpy as np
    import anyplotlib as apl

    x = np.linspace(0, 4 * np.pi, 400)
    y = np.sin(x) * np.exp(-x / 12)

    fig, ax = apl.subplots(1, 1, figsize=(560, 340))
    plot = ax.plot(y, axes=[x], color="#4fc3f7")

    point = plot.add_point_widget(x=3.0, y=0.5, color="#ff1744",
                                  show_crosshair=True)

    fig





.. raw:: html

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

Snap the point onto the curve
-----------------------------
A ``pointer_move`` handler fires while the point is dragged.  Here we read
``point.x``, look up the nearest sample, and push the point back onto the
curve with :meth:`~anyplotlib.Widget.set` — a one-line "snap to data" cursor.

.. GENERATED FROM PYTHON SOURCE LINES 30-41

.. code-block:: Python



    @point.add_event_handler("pointer_move")
    def _snap(event):
        i = int(np.clip(np.searchsorted(x, point.x), 0, len(x) - 1))
        point.set(y=float(y[i]))


    fig.set_help("Drag the point — it snaps onto the curve as you move it.")

    fig  # Interactive




.. raw:: html

    <div style="display:block;text-align:center;line-height:0;margin:12px 0;"><div id="sphx_glr_plot_widget1d_point_002" class="awi-fig-wrap" data-awi-fig="sphx_glr_plot_widget1d_point_002" style="display:inline-block;overflow:hidden;position:relative;width:576px;height:356px;"><iframe src="../../_static/viewer_widgets/sphx_glr_plot_widget1d_point_002.html" data-awi-fig="sphx_glr_plot_widget1d_point_002" frameborder="0" scrolling="no" style="width:576px;height:356px;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_widget1d_point_002"><button class="awi-badge-icon awi-activate-btn" data-awi-fig="sphx_glr_plot_widget1d_point_002" title="Make interactive (boots Pyodide — may take ~10 s)">&#x26A1;</button></div></div><script>(function(){var wrap=document.getElementById('sphx_glr_plot_widget1d_point_002'),ifr=wrap.querySelector('iframe'),nw=576,nh=356;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_widget1d_point_002" data-fig-index="1" data-src-file="plot_widget1d_point" data-src="&quot;\&quot;\&quot;\&quot;\n1D Point Widget\n===============\n\nA free-moving ``(x, y)`` control point on a 1-D panel, with an optional\ncrosshair.  Unlike the vertical / horizontal line widgets it moves in both\ndirections, so it is handy as a draggable data cursor or a control handle for\nan interactive fit.  Add it with :meth:`~anyplotlib.Plot1D.add_point_widget`.\n\&quot;\&quot;\&quot;\nimport numpy as np\nimport anyplotlib as apl\n\nx = np.linspace(0, 4 * np.pi, 400)\ny = np.sin(x) * np.exp(-x / 12)\n\nfig, ax = apl.subplots(1, 1, figsize=(560, 340))\nplot = ax.plot(y, axes=[x], color=\&quot;#4fc3f7\&quot;)\n\npoint = plot.add_point_widget(x=3.0, y=0.5, color=\&quot;#ff1744\&quot;,\n                              show_crosshair=True)\n\nfig\n\n# %%\n# Snap the point onto the curve\n# -----------------------------\n# A ``pointer_move`` handler fires while the point is dragged.  Here we read\n# ``point.x``, look up the nearest sample, and push the point back onto the\n# curve with :meth:`~anyplotlib.Widget.set` \u2014 a one-line \&quot;snap to data\&quot; cursor.\n\n\n@point.add_event_handler(\&quot;pointer_move\&quot;)\ndef _snap(event):\n    i = int(np.clip(np.searchsorted(x, point.x), 0, len(x) - 1))\n    point.set(y=float(y[i]))\n\n\nfig.set_help(\&quot;Drag the point \u2014 it snaps onto the curve as you move it.\&quot;)\n\nfig  # Interactive\n&quot;"></script>







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

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


.. _sphx_glr_download_auto_examples_Widgets_plot_widget1d_point.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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