整理附录中的“等值线标注和线条标注”至 grdcontour/contour/plot 模块中

[core-man]

问题描述

• GMT 绘制等值线及标注：grdcontour 和 contour 模块可以绘制等值线，每条等值线都可以附加一个标注
• GMT 绘制线条标注：plot 和 plot3d 模块可以绘制带有标注的线段（-Sq 选项）

如何优化等值线/线段标注的位置是一个很困难的主题。GMT 提供了不同的算法来确定标注的位置，并且可以自由地指定标注的属性。

附录中的等值线标注和“线条标注”这一小节主要总结了等值线/线段标注问题：

• 标注位置的确定方法
• 标注属性的确定方法
• 给出了一些应用实例

这三部分内容涉及到 grdcontour、contour、plot、plot3d 四个模块的 1-2 个选项：

• 标注的位置部分主要关于：grdcontour 和 contour 模块的 -G 选项、plot 和 plot3d 模块的 -Sq 选项
• 标注的属性部分主要关于：grdcontour 和 contour 模块的 -A 选项、plot 和 plot3d 模块的 -Sq 选项
• 实例部分主要是 grdcontour 的标注位置图例、属性图例以及综合图例

此小节内容并不适合放入GMT入门，也不是GMT基础，因而被长期至于附录中存放。

解决办法

建议将此小节内容整理至相应模块中，目前我思考的整理方式和顺序如下：

1. 整理与 grdcontour 有关的所有内容（约 5 个 PR）

   • 标注的位置部分中与 -G 选项相关的内容
   • 标注的属性部分中与 -A 选项相关的内容
   • 实例部分：grdcontour 的标注位置图例
   • 实例部分：grdcontour 的标注属性图例
   • 实例部分：grdcontour 的标注综合图例

2. 整理与 contour 有关的所有内容（约 2 个 PR）

   • 标注的位置部分中与 -G 选项相关的内容
   • 标注的属性部分中与 -A 选项相关的内容

3. 整理与 plot 有关的所有内容（约 2 个 PR）

   • 标注的位置部分中与 -Sq 选项相关的内容
   • 标注的属性部分中与 -Sq 选项相关的内容

由于 plot3d 模块暂时未翻译，暂时不整理。并且日后翻译和整理 plot3d 的线条标注时，参考 plot 即可。

---

此建议最早提出于 #253 (comment).

[core-man]

#166 中提出增加“如何绘制等值线”的入门教程，或许实例部分也可以直接用于此教程的建设。

[core-man]

小提示：附录中的等值线标注和“线条标注”这一小节主要来自 GMT 官方手册 Cookbook/19. Annotation of Contours and “Quoted Lines”.