:orphan:

Examples
========

A collection of short, self-contained examples.

.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. thumbnail-parent-div-close

.. raw:: html

    </div>

Benchmarks
----------

Timing comparisons for the Python-side data-push pipeline in anyplotlib,
matplotlib, Plotly, and Bokeh.  All measurements capture only the
**Python serialisation cost** — the bottleneck in a live Jupyter session
where new data must be encoded and dispatched to the browser on every frame.



.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="There are a couple of different &quot;costs&quot; asscociated with rendering plots and images. There is usually a Python-side cost as well as a browser-side rendering cost. We&#x27;ve broken down those two costs here comparing different libraries for the first cost.  The second is harder to measure.  We&#x27;ve done it for anyplotlib but doing it for ipympl, bokeh and plotly is a little more difficult.">

.. only:: html

  .. image:: /auto_examples/Benchmarks/images/thumb/sphx_glr_plot_benchmark_comparison_thumb.png
    :alt:

  :doc:`/auto_examples/Benchmarks/plot_benchmark_comparison`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plot Update Comparison</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>

Interactive Examples
====================

Examples that use the callback / event system to connect widget
interactions to live Python computations.



.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="anyplotlib has a figure-level annotation layer that floats above the panels, positioned in figure fractions (0…1, origin top-left) rather than any panel&#x27;s data coordinates.  Set it with set_figure_markers; the supported kinds are &quot;text&quot;, &quot;circle&quot;, &quot;rect&quot; and &quot;arrow&quot;.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_figure_annotations_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_figure_annotations`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Interactive figure annotations — double-click to add, drag to place</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates the PointWidget on a 1-D panel.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_point_widget_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_point_widget`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Draggable Point Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates the key_down event handler API: press a key while the plot is focused to add an overlay widget centred on the current cursor position, or press Backspace / Delete to remove the last widget you clicked.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_key_bindings_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_key_bindings`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Key-Press Widget Placement</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A side-by-side view: the left panel shows a synthetic 512×512 STEM image with a red overlay marking pixels above the threshold; the right panel shows a 32-bin intensity histogram with a yellow vertical line at the current threshold value.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_threshold_explorer_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_threshold_explorer`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Live intensity thresholding on a multi-phase STEM image.</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="An EBSD-style orientation explorer for a synthetic polycrystal:">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_ipf_explorer_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_ipf_explorer`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Inverse Pole Figure (IPF) Explorer</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable rectangle widget on a real-space image drives a live 2-D FFT of the selected region, displayed in a side-by-side panel.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_interactive_fft_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_interactive_fft`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Interactive FFT ROI</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Five synthetic EELS spectra (Carbon-rich, Nitride, Oxide, Silicide, Mixed) stacked vertically on a single axis, each with known characteristic edges and a power-law background.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_eels_explorer_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_eels_explorer`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">EELS multi-spectrum explorer.</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A side-by-side viewer for a 3-D (y, x, energy) dataset.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_3d_spectral_viewer_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_3d_spectral_viewer`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Interactive 3D Spectral Viewer</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Synthetic HAADF-STEM image with 18 Gaussian nanoparticles on a Poisson noise background.  Candidate peaks are detected automatically using a 7×7 local-maximum filter and marked with small grey circles.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_particle_picker_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_particle_picker`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">HAADF STEM nanoparticle picker.</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Click on any region of the image to flood-fill all pixels of similar intensity — the union of all seeded regions is shown as a live semi-transparent overlay on the original image.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_segment_by_contrast_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_segment_by_contrast`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Interactive Contrast Segmentation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A synthetic (256, 256, 300) EDS datacube — one 300-channel spectrum per scan position.  Four rectangular ROIs overlay the total-counts image (HAADF proxy).  Entering an ROI sums all spectra within the rectangle (spatial sum over every scan position in the box) and displays the result in the top-right panel.  Draggable coloured range widgets on the spectrum define the integration window for each element; each bar height is the channel sum of the ROI spectrum within that window.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_spectra_roi_inspector_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_spectra_roi_inspector`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">ROI-to-spectrum inspector for a 3-D EDS hyperspectral dataset.</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="An EBSD-style orientation explorer pairing a map with a density IPF:">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_ipf_density_map_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_ipf_density_map`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Inverse Pole Figure (IPF) Density Map</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="An orthoslice viewer for a synthetic 3-D polycrystal (voxel grain map), in the style of EBSD/tomography volume browsers:">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_voxel_grain_explorer_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_voxel_grain_explorer`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">3-D Voxel Grain Explorer</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A noisy composite signal built from two Gaussians is displayed.  Two additional overlay lines show the individual component curves and a white sum curve that always equals the current manual model.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_interactive_fitting_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_interactive_fitting`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Interactive 1-D Gaussian Fitting</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A 3 × 3 grid of synthetic images, each independently segmented by flood-fill.  Pass 8 or 9 images as images_flat; the grid always has 3 columns and enough rows to fit them all (last cell left blank when 8 images are supplied).">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_segment_by_contrast_advanced_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_segment_by_contrast_advanced`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Advanced Interactive Contrast Segmentation (3 × 3 Grid)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A celestial globe wired to a flat star map, with a sidereal clock.">

.. only:: html

  .. image:: /auto_examples/Interactive/images/thumb/sphx_glr_plot_star_globe_explorer_thumb.png
    :alt:

  :doc:`/auto_examples/Interactive/plot_star_globe_explorer`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Star Globe Explorer — a linked celestial sphere and sky map</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>

Markers
-------
A collection of short examples using markers

.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw static horizontal threshold lines on a 1-D plot with add_hlines. Use markers[&quot;hlines&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_horizontal_lines_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_horizontal_lines`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Horizontal Lines</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw static vertical marker lines on a 1-D plot with add_vlines. Use markers[&quot;vlines&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_vertical_lines_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_vertical_lines`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Vertical Lines</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Mark specific (x, y) positions on a 1-D plot with add_points. Use markers[&quot;points&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_points_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_points`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Points</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Place text annotations on a 2-D image with add_texts. Use markers[&quot;texts&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_texts_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_texts`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text Labels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw vector arrows on a 2-D image with add_arrows. Use markers[&quot;arrows&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_arrows_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_arrows`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Arrows</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Mark circular features on a 2-D image with add_circles. Use markers[&quot;circles&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_circles_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_circles`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Circles</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw bounding boxes on a 2-D image with add_rectangles. Use markers[&quot;rectangles&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_rectangles_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_rectangles`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Rectangles</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw line segments on a 2-D image with add_lines. Use markers[&quot;lines&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_line_segments_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_line_segments`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Line Segments</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw ellipses on a 2-D image with add_ellipses. Use markers[&quot;ellipses&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_ellipses_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_ellipses`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Ellipses</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw squares on a 2-D image with add_squares. Use markers[&quot;squares&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_squares_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_squares`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Squares</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Draw closed polygons on a 2-D image with add_polygons. Use markers[&quot;polygons&quot;][&quot;name&quot;].set(...) to update them live.">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_polygons_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_polygons`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Polygons</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Every add_* marker method takes a transform that decides which coordinate system its positions live in:">

.. only:: html

  .. image:: /auto_examples/Markers/images/thumb/sphx_glr_plot_transform_markers_thumb.png
    :alt:

  :doc:`/auto_examples/Markers/plot_transform_markers`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Coordinate transforms — pin markers to the axes or the screen</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>

Plot Types
----------
A collection of short examples showing different plot types.

.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Two 1-D options that suit spectral data: a mid-riser step line (constant within each bin, jumping at bin midpoints) via linestyle=&quot;step-mid&quot;, and a logarithmic y-axis via semilogy (or ax.plot(..., yscale=&quot;log&quot;)).">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_step_and_log_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_step_and_log`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Step lines and log-scale spectra</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Overlay two series that live on very different scales on a single Plot1D panel, each with its own y-axis.  Enable the right-hand axis with add_right_axis, then add curves to it with add_line(..., axis=&quot;right&quot;) — they are scaled and labelled independently of the left axis.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_twinx_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_twinx`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Twinned (secondary) y-axis</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Axis labels, titles, and the colorbar label accept an optional fontsize (in CSS pixels) and support a small TeX subset inside $...$ for scientific notation — superscripts, subscripts, Greek letters, and common symbols — rendered directly on the canvas with no MathJax dependency:">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_label_formatting_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_label_formatting`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Label Sizes and Scientific (TeX) Formatting</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrate the three 3-D geometry types supported by plot_surface, scatter3d, and plot3d. Drag to rotate, scroll to zoom, press R to reset the view.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_3d_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_3d`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">3D Plotting</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="voxels renders shaded translucent cubes for a volumetric field.  With gpu=&quot;auto&quot; (the default) anyplotlib uses WebGPU instancing when a GPU is available and the cube count is large, so hundreds of thousands of voxels stay interactive; otherwise it falls back to the Canvas2D path.  Read gpu_active after the first frame to see which path was chosen.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_gpu_voxels_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_gpu_voxels`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">GPU-accelerated voxels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrate pcolormesh with non-uniform (log-spaced) x-edges and irregularly-spaced y-edges, mirroring matplotlib.axes.Axes.pcolormesh.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_pcolormesh_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_pcolormesh`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">pcolormesh — non-linear axes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Plot a 1-D spectrum with a physical x-axis (energy in eV) using plot.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_spectra1d_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_spectra1d`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">1D Spectra</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Floating informational sub-plots that overlay the main figure — useful for displaying supplementary data alongside a primary image, as seen in orientation mapping, phase analysis, and similar workflows.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_inset_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_inset`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Inset Plots</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Display a 2-D image with physical axes, a colourmap, and an interactive histogram below — all wired together with draggable threshold widgets.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_image2d_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_image2d`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Image with Histogram</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates the line-style, opacity, and per-point marker parameters available on plot and add_line.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_line_styles_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_line_styles`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">1D Line Styles</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrate bar with:">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_bar_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_bar`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Bar Chart</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Some plots are coloured by a direction, not by a magnitude, and a colorbar cannot say what the colours mean.  An orientation map is coloured by which crystal axis points at you; a polarization map by which way the moment lies in the plane.  Both need a small picture as their legend: an inverse pole figure triangle, or a hue wheel.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_key_overlays_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_key_overlays`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Floating keys — IPF triangles and colour wheels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="GridSpec lets you build multi-panel figures where panels have different sizes and span multiple grid cells.  This gallery shows the most common patterns.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_gridspec_custom_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_gridspec_custom`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Custom Grid Layouts with GridSpec</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="For a very large image, anyplotlib does not need the whole array.  It asks a TileBackend for a downsampled overview to use as the base texture, and then — on every zoom / pan — for a crisp detail tile of just the visible region at the panel&#x27;s resolution. anyplotlib owns that zoom/pan → re-tile lifecycle; the backend owns the data.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_tile_backend_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_tile_backend`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Custom Tile Backend — pan & zoom a huge image you never hold in memory</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="set_texture wraps an image around any 3-D surface, so the picture follows the geometry as you orbit it.  Here we build an equirectangular star map from a real bright-star catalogue and project it onto the celestial sphere.">

.. only:: html

  .. image:: /auto_examples/PlotTypes/images/thumb/sphx_glr_plot_3d_texture_thumb.png
    :alt:

  :doc:`/auto_examples/PlotTypes/plot_3d_texture`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Textured 3-D surfaces — a celestial globe</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>

Widgets
-------
Short examples of using widgets in anyplotlib

.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable horizontal line on a 1-D plot panel. Add it with add_hline_widget. Drag the line up or down to change the selected y value.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget1d_hline_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget1d_hline`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">1D Horizontal Line Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable vertical line on a 1-D plot panel. Add it with add_vline_widget. Drag the line left or right to change the selected x position.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget1d_vline_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget1d_vline`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">1D Vertical Line Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable range selector on a 1-D plot panel with two handles. Add it with add_range_widget. Drag either handle to resize the selected interval, or drag the band to move it.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget1d_range_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget1d_range`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">1D Range Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable crosshair overlay that snaps to a single [x, y] position on a 2-D image panel.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_crosshair_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_crosshair`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Crosshair Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable, resizable circle overlay on a 2-D image panel. Add it with add_widget using kind=&quot;circle&quot;.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_circle_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_circle`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Circle Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable, resizable rectangle overlay on a 2-D image panel. Add it with add_widget using kind=&quot;rectangle&quot;.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_rectangle_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_rectangle`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Rectangle Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable annular (ring) overlay for selecting a radial band on a 2-D image. Drag the inner or outer ring to adjust the radii.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_annular_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_annular`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Annular Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable text label overlay on a 2-D image panel. Specify position with x, y (pixel coordinates), text, and fontsize.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_label_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_label`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Label Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable polygon overlay whose individual vertices can be repositioned. Pass vertices as a list of [x, y] pixel coordinates.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_polygon_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_polygon`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Polygon Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="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 add_point_widget.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget1d_point_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget1d_point`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">1D Point Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="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 add_arrow_widget.">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget2d_arrow_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget2d_arrow`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">2D Arrow Widget</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A draggable axis-aligned plane in a 3-D panel, rendered as a translucent quad spanning the panel&#x27;s bounds.  Drag it in the browser to slide it along its normal — ideal as a slice selector through a volume or point cloud.  Add it with plot.add_widget(&quot;plane&quot;, axis=..., position=...).">

.. only:: html

  .. image:: /auto_examples/Widgets/images/thumb/sphx_glr_plot_widget3d_plane_thumb.png
    :alt:

  :doc:`/auto_examples/Widgets/plot_widget3d_plane`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">3D Plane Widget</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:
   :includehidden:


   /auto_examples/Benchmarks/index.rst
   /auto_examples/Interactive/index.rst
   /auto_examples/Markers/index.rst
   /auto_examples/PlotTypes/index.rst
   /auto_examples/Widgets/index.rst


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

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

      :download:`Download all examples in Python source code: auto_examples_python.zip </auto_examples/auto_examples_python.zip>`

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

      :download:`Download all examples in Jupyter notebooks: auto_examples_jupyter.zip </auto_examples/auto_examples_jupyter.zip>`


.. only:: html

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

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