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

.. only:: html

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

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

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

.. _sphx_glr_gallery_miscellaneous_00.logos.py:


============
Mpltern logo
============

This example generates the current mpltern logo.
This is based on the `matplotlib logo
<https://matplotlib.org/stable/gallery/misc/logos2.html>`__.
The dark-mode logo is also obtained with ``MPL_BLUE = '#65baea'``.

.. GENERATED FROM PYTHON SOURCE LINES 11-117

.. code-block:: Python

    import matplotlib.pyplot as plt

    import matplotlib.font_manager
    from matplotlib.patches import PathPatch
    from matplotlib.text import TextPath
    import matplotlib.transforms as mtrans
    import mpltern  # noqa: F401

    MPL_BLUE = '#11557c'


    def get_font_properties():
        return matplotlib.font_manager.FontProperties(weight='bold')


    def create_icon_axes(fig, ax_position, lw_grid, lw_border):
        """
        Create a ternary axes containing the mpltern span plot.

        Parameters
        ----------
        fig : matplotlib.figure.Figure
            The figure to draw into.
        ax_position : (float, float, float, float)
            The position of the created Axes in figure coordinates as
            (x, y, width, height).
        lw_grid : float
            The linewidth of the grid.
        lw_border : float
            The linewidth of the Axes border.

        Returns
        -------
        ax : matplotlib.axes.Axes
            The created Axes.
        """
        with plt.rc_context({'axes.edgecolor': MPL_BLUE,
                             'axes.linewidth': lw_border}):
            ax = fig.add_axes(ax_position, projection='ternary')

            ax.axtspan(0.4, 0.6, color='C0', alpha=0.6)
            ax.axlspan(0.4, 0.6, color='C1', alpha=0.6)
            ax.axrspan(0.4, 0.6, color='C2', alpha=0.6)

            ax.tick_params(
                tick1On=False, tick2On=False, label1On=False, label2On=False)

            ax.grid(lw=lw_grid, color='0.9')
            # the actual visible background - extends a bit beyond the axis
            ax.fill(
                (1.04, -0.02, -0.02),
                (-0.02, 1.04, -0.02),
                (-0.02, -0.02, 1.04),
                facecolor='white', zorder=0,
                clip_on=False, in_layout=False)
            return ax


    def create_text_axes(fig, height_px):
        """Create an Axes in *fig* that contains 'mpltern' as Text."""
        ax = fig.add_axes((0, 0, 1, 1))
        ax.set_aspect("equal")
        ax.set_axis_off()

        path = TextPath((0, 0), "mpl  tern", size=height_px * 0.8,
                        prop=get_font_properties())

        angle = 4.25  # degrees
        trans = mtrans.Affine2D().skew_deg(angle, 0)

        patch = PathPatch(path, transform=trans + ax.transData, color=MPL_BLUE,
                          lw=0)
        ax.add_patch(patch)
        ax.autoscale()


    def make_logo(height_px, lw_grid, lw_border, with_text=False):
        """
        Create a full figure with the mpltern logo.

        Parameters
        ----------
        height_px : int
            Height of the figure in pixel.
        lw_grid : float
            The linewidth of the grid.
        lw_border : float
            The linewidth of icon border.
        with_text : bool
            Whether to draw only the icon or to include 'mpltern' as text.
        """
        dpi = 100
        height = height_px / dpi
        figsize = (5 * height, height) if with_text else (height, height)
        fig = plt.figure(figsize=figsize, dpi=dpi)
        fig.patch.set_alpha(0)

        if with_text:
            create_text_axes(fig, height_px)

        ax_pos = (0.395, 0.12, .17, 0.75) if with_text else (0.1, 0.1, 0.8, 0.8)
        ax = create_icon_axes(fig, ax_pos, lw_grid, lw_border)

        return fig, ax









.. GENERATED FROM PYTHON SOURCE LINES 118-119

A large logo:

.. GENERATED FROM PYTHON SOURCE LINES 119-122

.. code-block:: Python


    make_logo(height_px=110, lw_grid=0.5, lw_border=1)




.. image-sg:: /gallery/miscellaneous/images/sphx_glr_00.logos_001.svg
   :alt: 00.logos
   :srcset: /gallery/miscellaneous/images/sphx_glr_00.logos_001.svg
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 123-124

A small 32px logo:

.. GENERATED FROM PYTHON SOURCE LINES 124-127

.. code-block:: Python


    make_logo(height_px=32, lw_grid=0.3, lw_border=0.3)




.. image-sg:: /gallery/miscellaneous/images/sphx_glr_00.logos_002.svg
   :alt: 00.logos
   :srcset: /gallery/miscellaneous/images/sphx_glr_00.logos_002.svg
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 128-129

A large logo including text, as used on the mpltern website.

.. GENERATED FROM PYTHON SOURCE LINES 129-133

.. code-block:: Python


    make_logo(height_px=110, lw_grid=0.5, lw_border=1,
              with_text=True)
    plt.show()



.. image-sg:: /gallery/miscellaneous/images/sphx_glr_00.logos_003.svg
   :alt: 00.logos
   :srcset: /gallery/miscellaneous/images/sphx_glr_00.logos_003.svg
   :class: sphx-glr-single-img






.. _sphx_glr_download_gallery_miscellaneous_00.logos.py:

.. only:: html

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

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

      :download:`Download Jupyter notebook: 00.logos.ipynb <00.logos.ipynb>`

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

      :download:`Download Python source code: 00.logos.py <00.logos.py>`


.. only:: html

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

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