Add gallery example for directional roses

[michaelgrund]

Description of proposed changes

This PR adds a gallery example to show the usage of map roses.

Preview:

https://pygmt-dev--4010.org.readthedocs.build/en/4010/gallery/embellishments/directional_roses.html

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]

Cool - will look at the plots in detail later on.

But just want to mention that there is an issue suggesting to implemente a high-level methods for plotting a directional rose etc. at #2831 (similar to plot / plot3d at #2797). Not sure if there is any progress at the moment, but would be good to check to avoid double work 🙃. As the script contains various plots, it looks like you put already some work into this PR.

[seisman]

But just want to mention that there is an issue suggesting to implemente a high-level methods for plotting a directional rose etc. at #2831 (similar to plot / plot3d at #2797). Not sure if there is any progress at the moment

It's still waiting for the new alias system.

[seisman]

Instead of plotting eight roses in eight subplots, maybe it's better to plot eight roses in a single basemap?

[seisman]

@michaelgrund @yvonnefroehlich I've opened PR #4025 which adds the Figure.directional_rose method. With that feature added, this gallery example can be greatly simplified. So better to focus on that PR first?

[michaelgrund]

@michaelgrund @yvonnefroehlich I've opened PR #4025 which adds the Figure.directional_rose method. With that feature added, this gallery example can be greatly simplified. So better to focus on that PR first?

Great, will wait until #4025 is merged!

[seisman]

@michaelgrund The Figure.directional_rose method in PR #4025 has been merged. You may want to revisit this example if you're still interested.

[seisman]

I feel it would be better if we could find all GMT parameters (e.g., FONT_TITLE) that control the appearance of map roses and provide dedicated parameters for them. For example, it's sometimes confusing that the label font is controlled by FONT_TITLE rather than FONT_LABEL. It would be more user-friendly if we can provide a parameter like font_label (or labe_font).

Anyway, we can finish this gallery example first, then implement these parameters and update the gallery example in separate PRs.

[seisman]

Ping @michaelgrund

[michaelgrund]

/format

[seisman]

Please rewrap the short lines to 88 characters, then I think this PR should be good for merging.

[yvonnefroehlich]

Looks good (just the line length 🙃).