DOC: Add gallery example for PyGMT logo

examples/gallery/embellishments/pygmtlogo.py

@@ -0,0 +1,58 @@
+"""
+PyGMT logo
+==========
+Beside the GMT logo, there is a separate PyGMT logo which can be plotted and added to a
+figure using :meth:`pygmt.Figure.pygmtlogo`. The design of the logo itself is kindly
+provided by `@sfrooti <https://github.com/sfrooti>`_ and consists of a visual and the
+wordmark "PyGMT".
+
+The visual is available in circle and hexagon shapes. It can be plotted using colors
+of Python (blue Earth and yellow compass lines) and GMT (red letters GMT) or in black
+and white as well as in light or dark mode. The wordmark can be added on the right
+side or at the bottom of the visual.
+"""
+
+# %%
+import pygmt
+
+# %%
+# Plot the PyGMT logo without any arguments:
+
+fig = pygmt.Figure()
+fig.pygmtlogo()
+fig.show()
+
+
+# %%
+# Via the ``color``, ``theme``, ``shape`` parameters the appereance of the logo can be
+# changed:
+
+fig = pygmt.Figure()
+fig.basemap(region=[-1, 1, -1, 1], projection="X4.5c/4.5c", frame="+g180/199/231")
+
+fig.pygmtlogo(color=False, position="TL")
+
+fig.pygmtlogo(theme="dark", position="TR")
+
+fig.pygmtlogo(color=False, theme="dark", position="BL")
+
+fig.pygmtlogo(shape="hexagon", position="BR")
+
+fig.show()
+
+
+# %%
+# Via the ``wordamrk`` parameter the text "PyGMT" can be added on the right side
+# or at the bottom of the visual:
+
+fig = pygmt.Figure()
+fig.basemap(region=[-1, 1, -1, 1], projection="X7c/5c", frame="+g180/199/231")
+
+fig.pygmtlogo(wordmark="horizontal", position="TC", width="6c")
+
+fig.pygmtlogo(theme="dark", wordmark="vertical", position="BC", height="3c")
+
+fig.show()
+
+
+# sphinx_gallery_thumbnail_number = 3