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.

The GMT CLI syntax:

-Td[g|j|J|n|x]refpoint[+f|F[level]][+jjustify][+l[w,e,s,n]][+odx[/dy]][+wwidth]

The Pythonic long-forma parameters are:

• g|j|J|n|x: position_type
• refpoint: position
• +j: anchor
• +o: anchor_offset
• +w: width
• +l: label [Maybe labels, since label is an alias for common option -l?]
• +f: fancy
• +F: not implemented yet

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="mapcoords")
fig.show()

Preview: https://pygmt-dev--4025.org.readthedocs.build/en/4025/api/generated/pygmt.Figure.directional_rose.html

Addressing #2831. Related to #4010.

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.