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

.. only:: html

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

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

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

.. _sphx_glr_gallery_layouts_02_complex_layout_insets.py:


Complex layout with insets
=========================

A mixed layout using blank slots, insets, and multiple plot types.

Why UltraPlot here?
-------------------
UltraPlot accepts nested layout arrays directly and keeps spacing consistent
across panels and insets. You get a publication-style multi-panel figure without
manual GridSpec bookkeeping.

Key functions: :py:func:`ultraplot.subplots`, :py:meth:`ultraplot.axes.Axes.inset_axes`.

See also
--------
* :doc:`Subplots and layouts </subplots>`
* :doc:`Insets and panels </insets_panels>`

.. GENERATED FROM PYTHON SOURCE LINES 20-64



.. image-sg:: /gallery/layouts/images/sphx_glr_02_complex_layout_insets_001.png
   :alt: Complex layout with insets and mixed plots, Signal with local variability, Stacked composition, Spatial field, Relationship
   :srcset: /gallery/layouts/images/sphx_glr_02_complex_layout_insets_001.png
   :class: sphx-glr-single-img





.. code-block:: Python


    import numpy as np

    import ultraplot as uplt

    rng = np.random.default_rng(7)
    layout = [[1, 1, 2, 2], [3, 3, 3, 4]]
    fig, axs = uplt.subplots(layout, share=0, refwidth=1.4)

    # Panel A: time series with inset zoom.
    x = np.linspace(0, 20, 400)
    y = np.sin(x) + 0.3 * np.cos(2.5 * x) + 0.15 * rng.standard_normal(x.size)
    axs[0].plot(x, y, lw=2)
    axs[0].format(title="Signal with local variability", ylabel="Amplitude")
    inset = axs[0].inset_axes([0.58, 0.52, 0.35, 0.35], zoom=0)
    mask = (x > 6) & (x < 10)
    inset.plot(x[mask], y[mask], lw=1.6, color="black")
    inset.format(xlabel="Zoom", ylabel="Amp", grid=False)

    # Panel B: stacked bar chart.
    categories = np.arange(1, 6)
    vals = rng.uniform(0.6, 1.2, (3, categories.size)).cumsum(axis=0)
    axs[1].bar(categories, vals[0], label="Group A")
    axs[1].bar(categories, vals[1] - vals[0], bottom=vals[0], label="Group B")
    axs[1].bar(categories, vals[2] - vals[1], bottom=vals[1], label="Group C")
    axs[1].format(title="Stacked composition", xlabel="Sample", ylabel="Value")
    axs[1].legend(loc="right", ncols=1, frame=False)

    # Panel C: heatmap with colorbar.
    grid = rng.standard_normal((40, 60))
    image = axs[2].imshow(grid, cmap="Fire", aspect="auto")
    axs[2].format(title="Spatial field", xlabel="Longitude", ylabel="Latitude")
    axs[2].colorbar(image, loc="r", label="Intensity")

    # Panel D: scatter with trend line.
    x = rng.uniform(0, 1, 120)
    y = 0.8 * x + 0.2 * rng.standard_normal(x.size)
    axs[3].scatter(x, y, s=30, alpha=0.7)
    axs[3].plot([0, 1], [0, 0.8], lw=2, color="black", linestyle="--")
    axs[3].format(title="Relationship", xlabel="Predictor", ylabel="Response")

    axs.format(abc=True, abcloc="ul", suptitle="Complex layout with insets and mixed plots")

    fig.show()


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

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


.. _sphx_glr_download_gallery_layouts_02_complex_layout_insets.py:

.. only:: html

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

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

      :download:`Download Jupyter notebook: 02_complex_layout_insets.ipynb <02_complex_layout_insets.ipynb>`

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

      :download:`Download Python source code: 02_complex_layout_insets.py <02_complex_layout_insets.py>`

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

      :download:`Download zipped: 02_complex_layout_insets.zip <02_complex_layout_insets.zip>`


.. only:: html

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

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