.. _sphx_glr_gallery_favicon.py:


Cartopy Favicon
---------------

The actual code to generate cartopy's favicon.





.. image:: /gallery/images/sphx_glr_favicon_001.png
    :align: center





.. code-block:: python

    import cartopy.crs as ccrs
    import matplotlib.pyplot as plt
    import matplotlib.textpath
    import matplotlib.patches
    from matplotlib.font_manager import FontProperties
    import numpy as np


    def main():
        fig = plt.figure(figsize=[8, 8])
        ax = fig.add_subplot(1, 1, 1, projection=ccrs.SouthPolarStereo())

        ax.coastlines()
        ax.gridlines()

        im = ax.stock_img()

        def on_draw(event=None):
            """
            Hook into matplotlib's event mechanism to define the clip path of the
            background image.

            """
            # Clip the image to the current background boundary.
            im.set_clip_path(ax.background_patch.get_path(),
                             transform=ax.background_patch.get_transform())

        # Register the on_draw method and call it once now.
        fig.canvas.mpl_connect('draw_event', on_draw)
        on_draw()

        # Generate a matplotlib path representing the character "C".
        fp = FontProperties(family='Bitstream Vera Sans', weight='bold')
        logo_path = matplotlib.textpath.TextPath((-4.5e7, -3.7e7),
                                                 'C', size=1, prop=fp)

        # Scale the letter up to an appropriate X and Y scale.
        logo_path._vertices *= np.array([103250000, 103250000])

        # Add the path as a patch, drawing black outlines around the text.
        patch = matplotlib.patches.PathPatch(logo_path, facecolor='white',
                                             edgecolor='black', linewidth=10,
                                             transform=ccrs.SouthPolarStereo())
        ax.add_patch(patch)
        plt.show()


    if __name__ == '__main__':
        main()

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



.. container:: sphx-glr-footer


  .. container:: sphx-glr-download

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



  .. container:: sphx-glr-download

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

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

    `Generated by Sphinx-Gallery <https://sphinx-gallery.readthedocs.io>`_