WIP: Add Figure.directional_rose to plot a directional rose on map

[seisman]

Description of proposed changes

This PR adds the Figure.directional_rose method to plot a map directional rose on map. It wraps the basemap -Td/coast -Td options.

Addressing #2831. Related to #4010.

Example

import pygmt
fig = pygmt.Figure()
fig.basemap(region=[0, 80, -30, 30], projection="M10c", frame=True)
fig.directional_rose(position=(10, 10), position_type="user")
fig.show()

Preview: https://pygmt-dev--4025.org.readthedocs.build/en/4025/api/generated/pygmt.Figure.directional_rose.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]

Hm. I am not sure if "justify" and "mirror" are suitable / understandable terms here, especially "mirror" appears a bit strange for me. Is this orientated on some other implementaiton or documentation?

[seisman]

GMT uses long names like mapcoords,inside,outside,boxcoords,plotcoords
https://github.com/GenericMappingTools/gmt/blob/98a9b39c1a94ff23dba8dd89fca9fae367432303/src/longopt/psbasemap_inc.h#L30

but gmtlogo uses user|map,justify,mirror,normalize,plot
https://github.com/GenericMappingTools/gmt/blob/98a9b39c1a94ff23dba8dd89fca9fae367432303/src/longopt/gmtlogo_inc.h#L29

[seisman]

All the parameters/arguments need more discussions.