POC: Code PyGMT logo in PyGMT

[yvonnefroehlich]

Description of proposed changes

Related to #1404 (comment), create the PyGMT logo in Python with PyGMT.

• Python script
• Separat method Figure.pygmtlogo or Figure.logo_pygmt as part of the Figure class or addition to the method Figure.logo (which plots the GMT logo)
• Gallery example

Preview:

• Documentation: https://pygmt-dev--3849.org.readthedocs.build/en/3849/api/generated/pygmt.Figure.pygmtlogo.html
• Gallery example: https://pygmt-dev--3849.org.readthedocs.build/en/3849/gallery/embellishments/pygmt_logo.html
• Script by @seisman to generate all versions See POC: Code PyGMT logo in PyGMT #3849 (comment); modified version to use the changed parameter names at POC: Code PyGMT logo in PyGMT #3849 (comment)
• All combinations: https://pygmt-dev--3849.org.readthedocs.build/en/3849/_images/sphx_glr_pygmt_logo_004.png
  

Related to

• Design a logo for PyGMT #1404
• Add a separate function to generate the PyGMT logo? #3848
• POC: Add PyGMT logo to README & docs #3845

TODO:

• Update intro comment of this PR
• Remove temporary files (eps)
• Include adding a wordmark and it's orientation to the input at the beginning
• Update codes to finale version of the visual
  • space between horizontal line of letter G and letter M (POC: Code PyGMT logo in PyGMT #3849 (comment))
  • ending of yellow line at the right side of letter M (POC: Code PyGMT logo in PyGMT #3849 (comment))
  • clean boundary of shape (0aea0b0)
  • etc.
• Introduce variables
• Improve parameter names, e.g., shape="circle" | "hexagon" or hex=False | True
• Convert to function (remove show and rdeuce save to tempoary eps files, replot via Figure.image)
• Remove saving as eps file for rotation (first get ride of transparent margin)
• Remove saving as eps file for adding wordmark (different basemaps due to horizontal and vertical orientation)
• Convert to a method of the Figure class or addition to Figure.logo.
• Add or expand gallery example to use the method
• Explain the story behind the logo in the gallery example

Issues:

• Get ride of white or transparent margin
• Currently the rotation and adding the wordmark are done in new Figure objects using the saved eps files. Maybe this is not easy to handle when converting to a method of the Figure classe.
• Decide about font for the wordmark (font Space Grotesk by Florian Karsten not available in GMT)
• No direct export to SVG format possible
• etc.

Reminders

• Run make format and make check to make sure the code follows the style guide.
• Add tests for new features or tests that would have caught the bug that you're fixing.
• Add new public functions/methods/classes to doc/api/index.rst.
• Write detailed docstrings for all functions/methods.
• If wrapping a new module, open a 'Wrap new GMT module' issue and submit reasonably-sized PRs.
• If adding new functionality, add an example to docstrings or tutorials.

Slash Commands

You can write slash commands (/command) in the first line of a comment to perform
specific operations. Supported slash command is:

• /format: automatically format and lint the code

[yvonnefroehlich]

/format

[michaelgrund]

I feel the logo definition should be separated into a standalone method, similar to the method to plot the GMT logo. This would allow to plot the PyGMT logo by calling something like pygmt.Figure.pygmt_logo. The individual formats could be selected by different input parameters like you did or hex = True or darkmode = True.

[yvonnefroehlich]

ruff v0.10.0 was released 2 hours ago causing the newly falling code style checks.

[seisman]

1. Updated animation for producing the logo step by step. It looks pretty good:
   

2. The "hexagon"-shape logo is not ideal, especially how the yellow compass lines intersect with the blue hexagon outline. I'm thinking if we should drop the hexagon logo in the initial version and add it later if there is still interest.

3. What about renaming variables like color_blue to blue, to make the codes shorter?

[yvonnefroehlich]

I made two small updates (i) slightly smaller arrow head for letter T and (ii) shorten the vertical compass line:

old	new

So far I removed color from the variable names color_blue, color_yellow, and color_red.
I agree, the for the hexagon shape, the compass lines are not optimal.

[yvonnefroehlich]

I adjusted the position of the wordmark:

circle	hexagon (for completness included)

In case we keep or when we later add the hexagon version, we should make the circle and hexagon versions have the same overall size.

[yvonnefroehlich]

Just tried to adjust the codes to make the hexagon version look at bit better.

Now, the compass lines match the hexagon better, but letter T is a bit short.

[seisman]

@yvonnefroehlich Just in case it’s helpful, I’ve pushed the layered-animation branch, which contains a single commit fd97aea. This commit adds a simple feature: it saves the current figure as frame-xxx.png each time a plotting method is called.

When you run the Figure.pygmtlogo method, you’ll get multiple frame-xxx.png files, which you can then convert into an animation using a command like:

magick -delay 50 -loop 0 frame-*.png animation.gif

[seisman]

Instead of defining variables like hex_factor/y_vertline/y_arrow. Can we just define different radii for circle and hexagon shapes?

[yvonnefroehlich]

Hm, not sure, if this is easy possible. I think the critical point is that for the hexagon shape, the distance to the shape outlines varies, e.g., it is different between the horizontal compass lines and the vertical red line or the arrow for the letter T.

Maybe your are right and we should focus on the circle shape first (and if wanted or requested we can add the hexagon version later).

[seisman]

The logo will appear in Figure 2, but we don't have to finalize it before the manuscript is accepted. So we still have plenty of time to improve it.