Implement Figure.pygmtlogo for the PyGMT logo by seisman · Pull Request #4616 · GenericMappingTools/pygmt

seisman · 2026-05-02T08:27:45Z

This PR tracks the implementation of the PyGMT logos in different versions.

Logo implementation status

Variant	Colored + Light	Colored + Dark	Grayscale + Light	Grayscale + Dark
Circular, no wordmark	✅	✅	✅	✅
Circular, horizontal wordmark	✅	✅	✅	✅
Circular, vertical wordmark	✅	✅	✅	✅
Hexagon, no wordmark	✅	✅	✅	✅
Hexagon, horizontal wordmark	✅	✅	✅	✅
Hexagon, vertical wordmark	✅	✅	✅	✅

Related PRs and issues

Hexagon shape

Pro

Seems to be quite popular (even for Python)

Contra

lost of context / connection to Earth and compass
difficult of implement based on fractions rather than on empircal factors
difficult to make to logo conistent across both shapes
12 variants already for circle shape (color/bw, no/hor./vert. wordmark, light/dark), multiple tests with baseline images
longer code, difficult to maintain

Some important comments from #3849

hexagon shape: support or drop
Figure.pygmtlogo: Initial version for the circular, colored PyGMT logo #3849 (comment)
- outer endings of main compass lines -> coverage by other shape
- arrow length of letter T
- same figure size across shapes
- position of wordmark, distance to visual
examples: no projection and region parameters
- inline: Figure.pygmtlogo: Initial version for the circular, colored PyGMT logo #3849 (comment)
- gallery: separate PR
wordmark: consistency with GMT
radii: fractions
- integer: Figure.pygmtlogo: Initial version for the circular, colored PyGMT logo #3849 (comment)
- 128: Figure.pygmtlogo: Initial version for the circular, colored PyGMT logo #3849 (comment)
docstrings: support width and height parameters
- Figure.pygmtlogo: Initial version for the circular, colored PyGMT logo #3849 (review)

Known issues

After plotting the logo, -X+w is expected to shift the plotting origin in the x-direction by logo width, but it actually shifts more than that. It's likely an issue with the image module.

…GMT logo (#3849) Co-authored-by: Dongdong Tian <seisman.info@gmail.com> Co-authored-by: Michael Grund <23025878+michaelgrund@users.noreply.github.com> Co-authored-by: Wei Ji <23487320+weiji14@users.noreply.github.com>

github-actions · 2026-05-02T08:29:36Z

Summary of changed images

This is an auto-generated report of images that have changed on the DVC remote

Status	Path
added	pygmt/tests/baseline/test_pygmtlogo_design_circle-horizontal.png
added	pygmt/tests/baseline/test_pygmtlogo_design_circle-vertical.png
added	pygmt/tests/baseline/test_pygmtlogo_design_hexagon-horizontal.png
added	pygmt/tests/baseline/test_pygmtlogo_design_hexagon-vertical.png
added	pygmt/tests/baseline/test_pygmtlogo_wordmark_horizontal_circle.png
added	pygmt/tests/baseline/test_pygmtlogo_wordmark_horizontal_hexagon.png
added	pygmt/tests/baseline/test_pygmtlogo_wordmark_none_circle.png
added	pygmt/tests/baseline/test_pygmtlogo_wordmark_none_hexagon.png
added	pygmt/tests/baseline/test_pygmtlogo_wordmark_vertical_circle.png
added	pygmt/tests/baseline/test_pygmtlogo_wordmark_vertical_hexagon.png

Image diff(s)

Details

Added images

test_pygmtlogo_design_circle-horizontal.png

test_pygmtlogo_design_circle-vertical.png

test_pygmtlogo_design_hexagon-horizontal.png

test_pygmtlogo_design_hexagon-vertical.png

test_pygmtlogo_wordmark_horizontal_circle.png

test_pygmtlogo_wordmark_horizontal_hexagon.png

test_pygmtlogo_wordmark_none_circle.png

test_pygmtlogo_wordmark_none_hexagon.png

test_pygmtlogo_wordmark_vertical_circle.png

test_pygmtlogo_wordmark_vertical_hexagon.png

Modified images

Path	Old	New

Report last updated at commit 2197015

…_pygmtlogo_circle_no_wordmark (#4617) Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>

…4625)

…for readability (#4630)

…rrow (#4635)

…4634) Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>

…nd-white dark-theme logo (#4638)

…eter (#4687)

seisman · 2026-06-24T04:03:36Z

Considering that the paper is currently under the “Awaiting Editor Decision” status and will likely be accepted without another round of review, the next step will be proofreading, which will be our last opportunity to make any changes to the manuscript. If everything goes well, I expect the paper to be accepted within a few days and enter the proofreading stage in about two weeks.

In other words, we need to finalize the logos and make the v0.19.0 release within the next two weeks. I think we should decide whether there are any further changes needed for the logo designs. If everything looks good, we can ask the other maintainers for final reviews. If there are still choices to be made (e.g., #4616 (comment)), we can ask the other maintainers to vote on the remaining options.

seisman · 2026-06-29T03:08:59Z

@GenericMappingTools/pygmt-maintainers I think this PR is ready for final review.

In summary, it implements 24 variants of the PyGMT logo. You can preview all of the proposed designs here:
#4616 (comment) (Click "Details" in the "Image Diff" section).

The only remaining point under discussion is the color of the wordmark, i.e., whether the “GMT” letters should be black/white or red (see #4616 (comment), #4627 (comment), and #4616 (comment)).

Since we’d like to finalize the PyGMT logo for the upcoming v0.19.0 release, which will accompany the PyGMT paper, we’d really appreciate your feedback on the proposed designs and, in particular, your preference for the wordmark color.

michaelgrund · 2026-07-04T10:51:24Z

Sorry for answering late but my time is currently very limited due to parental leave. Potentially it's getting better in late July. Everything looks good to me, I really like that a logo can be used in various formats and colors very soon!

seisman added this to the 0.19.0 milestone May 2, 2026

seisman added the feature Brand new feature label May 2, 2026

seisman temporarily deployed to pr-tests May 2, 2026 08:27 — with GitHub Actions Inactive

seisman temporarily deployed to pr-tests May 2, 2026 12:49 — with GitHub Actions Inactive

seisman force-pushed the pygmtlogo branch from f8d51b4 to 4868c8aCompare May 2, 2026 12:50

seisman temporarily deployed to pr-tests May 2, 2026 12:50 — with GitHub Actions Inactive

seisman mentioned this pull request May 2, 2026
Figure.pygmtlogo: Force the default logo size to 2-cm and rename test_pygmtlogo to test_pygmtlogo_circle_no_wordmark #4617
Merged

Force the default logo size to 2-cm and rename test_pygmtlogo to test…
bd24b5a
…_pygmtlogo_circle_no_wordmark (#4617) Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>

seisman temporarily deployed to pr-tests May 6, 2026 11:16 — with GitHub Actions Inactive

Merge branch 'main' into pygmtlogo
0ce57a1

seisman temporarily deployed to pr-tests May 6, 2026 17:02 — with GitHub Actions Inactive

Add a test to check the design details of the circular logo (#4623)
091d62c

seisman temporarily deployed to pr-tests May 7, 2026 07:54 — with GitHub Actions Inactive

Figure.pygmtlogo: Add tests for the circular, black/white PyGMT logo (#…
c63767f
…4625)

seisman temporarily deployed to pr-tests May 7, 2026 22:39 — with GitHub Actions Inactive

Merge branch 'main' into pygmtlogo
9a91164

seisman temporarily deployed to pr-tests May 8, 2026 02:13 — with GitHub Actions Inactive

Figure.pygmtlogo: Simplify the code logic for defining colors (#4629)
21cb57a

seisman temporarily deployed to pr-tests May 9, 2026 10:02 — with GitHub Actions Inactive

Figure.pygmtlogo: Explicitly set the angle of diagonal compass lines …
7581ebf
…for readability (#4630)

seisman temporarily deployed to pr-tests May 9, 2026 13:27 — with GitHub Actions Inactive

Figure.pygmtlogo: Increase the gap around the vertical red line and a…
5c7d482
…rrow (#4635)

seisman temporarily deployed to pr-tests May 11, 2026 10:24 — with GitHub Actions Inactive

Figure.pygmtlogo: Set the region based on wordmark for easier design (#…
71f66dd
…4634) Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>

seisman temporarily deployed to pr-tests May 12, 2026 13:36 — with GitHub Actions Inactive

Figure.pygmtlogo: Remove the additional black outline for the black-a…
1ea6e8e
…nd-white dark-theme logo (#4638)

seisman temporarily deployed to pr-tests May 13, 2026 23:14 — with GitHub Actions Inactive

Figure.pygmtlogo: Parameterize existing tests (#4639)
4f09ba6

Figure.pygmtlogo: Extend the region to get rid of the 'no_clip' param…
3e00ddd
…eter (#4687)

seisman temporarily deployed to pr-tests June 24, 2026 01:06 — with GitHub Actions Inactive

Merge branch 'main' into pygmtlogo
e7e17e5

seisman had a problem deploying to pr-tests June 24, 2026 04:03 — with GitHub Actions Error

seisman temporarily deployed to pr-tests June 24, 2026 04:57 — with GitHub Actions Inactive

Merge branch 'main' into pygmtlogo
1acb452

seisman temporarily deployed to pr-tests June 25, 2026 01:04 — with GitHub Actions Inactive

Merge branch 'main' into pygmtlogo
185cc85

seisman temporarily deployed to pr-tests June 26, 2026 01:02 — with GitHub Actions Inactive

seisman added final review call This PR requires final review and approval from a second reviewer and removed needs review This PR has higher priority and needs review. labels Jun 29, 2026

Merge branch 'main' into pygmtlogo
ffd3ab5

seisman temporarily deployed to pr-tests June 30, 2026 03:02 — with GitHub Actions Inactive

Merge branch 'main' into pygmtlogo
2197015

seisman temporarily deployed to pr-tests July 2, 2026 04:59 — with GitHub Actions Inactive

seisman mentioned this pull request Jul 2, 2026
Post-acceptance TODOs for PyGMT paper #4708
Closed
23 tasks

michaelgrund approved these changes Jul 4, 2026
View reviewed changes

michaelgrund reviewed Jul 4, 2026
View reviewed changes

Comment threadpygmt/src/pygmtlogo.py

seisman merged commit b6c4820 into mainJul 4, 2026
23 of 24 checks passed

seisman deleted the pygmtlogo branch July 4, 2026 15:41

seisman mentioned this pull request Jul 7, 2026
Design a logo for PyGMT #1404
Closed

seisman removed the final review call This PR requires final review and approval from a second reviewer label Jul 23, 2026

seisman added this to PyGMT: Wrapping GMT modules Jul 23, 2026

seisman changed the title ~~Implement Figure.pygmtlogo for the PyGMT logo~~Figure.pygmtlogo: Plot PyGMT logosJul 23, 2026

seisman changed the title ~~Figure.pygmtlogo: Plot PyGMT logos~~Implement Figure.pygmtlogo for the PyGMT logoJul 27, 2026

seisman mentioned this pull request Jul 27, 2026
Figure.pygmtlogo: Plot PyGMT logos #4770
Closed
12 tasks

seisman removed this from PyGMT: Wrapping GMT modules Jul 27, 2026

Navigation Menu

Uh oh!

Implement Figure.pygmtlogo for the PyGMT logo - #4616

Implement Figure.pygmtlogo for the PyGMT logo#4616
seisman merged 31 commits into
mainfrom
pygmtlogo

seisman commented May 2, 2026•
edited
Loading

Uh oh!

github-actionsBot commented May 2, 2026•
edited
Loading

Added images

Modified images

Uh oh!

seisman commented Jun 24, 2026

Uh oh!

seisman commented Jun 29, 2026

Uh oh!

michaelgrund commented Jul 4, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

seisman commented May 2, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Logo implementation status

Related PRs and issues

Hexagon shape

Some important comments from #3849

Known issues

Uh oh!

github-actionsBot commented May 2, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary of changed images

Image diff(s)

Added images

Modified images

Uh oh!

seisman commented Jun 24, 2026

Uh oh!

seisman commented Jun 29, 2026

Uh oh!

michaelgrund commented Jul 4, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

seisman commented May 2, 2026•
edited
Loading

github-actionsBot commented May 2, 2026•
edited
Loading