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

.. only:: html

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

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

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

.. _sphx_glr__gallery_selection_tools_linear_selector_image.py:


Linear Selectors Image
======================

Example showing how to use a `LinearSelector` to selector rows or columns of an image. The subplot on the right
displays the data for the selector row and column.

.. GENERATED FROM PYTHON SOURCE LINES 8-73



.. image-sg:: /_gallery/selection_tools/images/sphx_glr_linear_selector_image_001.webp
   :alt: linear selector image
   :srcset: /_gallery/selection_tools/images/sphx_glr_linear_selector_image_001.webp
   :class: sphx-glr-single-img





.. code-block:: Python


    # test_example = false

    import fastplotlib as fpl
    from imageio import v3 as iio

    image_data = iio.imread("imageio:coins.png")

    figure = fpl.Figure(
        (1, 3),
        size=(700, 300),
        names=[["image", "selected row data", "selected column data"]]
    )

    # create an image
    image = figure[0, 0].add_image(image_data)

    # add a row selector
    image_row_selector = image.add_linear_selector(axis="y")

    # add column selector
    image_col_selector = image.add_linear_selector()

    # make a line to indicate row data
    line_image_row = figure[0, 1].add_line(image.data[0])

    # make a line to indicate column data
    line_image_col = figure[0, 2].add_line(image.data[:, 0])


    # callbacks to change the line data in subplot [0, 1]
    # to display selected row and selected column data
    def image_row_selector_changed(ev):
        ix = ev.get_selected_index()
        new_data = image.data[ix]
        # set y values of line with the row data
        line_image_row.data[:, 1] = new_data


    def image_col_selector_changed(ev):
        ix = ev.get_selected_index()
        new_data = image.data[:, ix]
        # set y values of line with the column data
        line_image_col.data[:, 1] = new_data


    # add event handlers, you can also use a decorator
    image_row_selector.add_event_handler(image_row_selector_changed, "selection")
    image_col_selector.add_event_handler(image_col_selector_changed, "selection")

    # programmatically set the selection or drag it with your mouse pointer
    image_row_selector.selection = 200
    image_col_selector.selection = 180

    figure.show()

    for subplot in figure:
        subplot.camera.zoom = 0.5


    # NOTE: `if __name__ == "__main__"` is NOT how to use fastplotlib interactively
    # please see our docs for using fastplotlib interactively in ipython and jupyter
    if __name__ == "__main__":
        print(__doc__)
        fpl.run()


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

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


.. _sphx_glr_download__gallery_selection_tools_linear_selector_image.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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