DOC: Add basic tutorial "Plotting single-parameter symbols"

[yvonnefroehlich]

Description of proposed changes

Add a basic tutorial for plotting symbols, explaining the style, size, and symbol parameters.

TODO: Multi parameter symbols ?

Related basic tutorials:

• Plotting lines: https://www.pygmt.org/dev/tutorials/basics/lines.html
• Plotting text: https://www.pygmt.org/dev/tutorials/basics/text.html
• Plotting polygons: DOC: Add basic tutorial "Plotting polygons" #3593

Fixes #3595

Preview: https://pygmt-dev--3598.org.readthedocs.build/en/3598/tutorials/basics/symbols.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.
• Use underscores (not hyphens) in names of Python files and directories.

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

[seisman]

Just want to let you know that the example can be simplified after #3602 is finished.

[yvonnefroehlich]

Just want to let you know that the example can be simplified after #3602 is finished.

In principle, I am fine with updating this tutorial later. Do you plan to get this new high-level Figure.scatter method into v0.14.0? As the symbol parameter will be new in v0.14.0 and there will be probably some confusion with the style and size parameters, I think we should have an example / tutorial explaining the usage and differences by these parameters.

[seisman]

Do you plan to get this new high-level Figure.scatter method into v0.14.0?

Yes.

As the symbol parameter will be new in v0.14.0 and there will be probably some confusion with the style and size parameters, I think we should have an example / tutorial explaining the usage and differences by these parameters.

The ultimate goal is let Figure.plot focus on plotting lines and polygons, and have separate plotting methods (e.g., Figure.scatter, Figure.rectangle, Figure.frontline and more) for other single-parameter and multi-parameter symbols/lines.

[yvonnefroehlich]

Maye we leave this PR as is for the moment and short before we release of v0.14.0 we can come back and apply updates based on the state of the planed high-level methods. Thus, I set this PR to draft.

[yvonnefroehlich]

Maye we leave this PR as is for the moment and short before we release of v0.14.0 we can come back and apply updates based on the state of the planed high-level methods. Thus, I set this PR to draft.

As we will not have Figure.scatter in v0.14.0 (please see #3602 (comment)), should we use this tutorial to explain the newly added symbol paramter or move this PR also to v0.15.0?

[seisman]

I still prefer to have this PR after Figure.scatter is implemented. To address your concern in #3595, we could update the docstring in plot/plot3d.

[yvonnefroehlich]

I still prefer to have this PR after Figure.scatter is implemented.

This is fine for me. Have changed the milestone to v0.15.0.