.. _sphx_glr_auto_examples_PlotTypes:

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>


.. toctree::
   :hidden:

   /auto_examples/PlotTypes/plot_step_and_log
   /auto_examples/PlotTypes/plot_twinx
   /auto_examples/PlotTypes/plot_label_formatting
   /auto_examples/PlotTypes/plot_3d
   /auto_examples/PlotTypes/plot_gpu_voxels
   /auto_examples/PlotTypes/plot_pcolormesh
   /auto_examples/PlotTypes/plot_spectra1d
   /auto_examples/PlotTypes/plot_inset
   /auto_examples/PlotTypes/plot_image2d
   /auto_examples/PlotTypes/plot_line_styles
   /auto_examples/PlotTypes/plot_bar
   /auto_examples/PlotTypes/plot_key_overlays
   /auto_examples/PlotTypes/plot_gridspec_custom
   /auto_examples/PlotTypes/plot_tile_backend
   /auto_examples/PlotTypes/plot_3d_texture