subplot
- 官方文档:
- 简介:
管理和设置子图模式
subplot 模块可以将当前纸张分隔成若干个网格区域，每个区域内都可以包含一张单独的子图。
subplot 模块提供了三条指令：
subplot begin 进入子图模式，并设置子图的布局
subplot set 用于指定接下来的绘图操作在哪一个子图中进行
subplot end 用于结束子图模式
在子图模式中，需要注意如下几点：
在使用 -J 选项时，可以使用 ? 来指定地图宽度或比例尺，此时，GMT会根据子图的大小自动确定最合适的地图尺寸
对于笛卡尔投影，若想要X和Y轴共用相同的比例尺，则可以使用 -Jx?
subplot begin 语法
gmt subplot begin nrowsxncols -F[f|s]width/height[+fwfracs/hfracs][+cdx/dy][+gfill][+ppen][+wpen] [ -A[autolabel][+j|Jrefpoint][+cdx/dy][+gfill][+ppen][+odx/dy][+r][+R][+v] ] [ -C[side]clearance ] [ -B[p|s]parameters ] [ -jflags ] [ -Mmargins ] [ -Rregion ] [ -Slayout ] [ -Ttitle ] [ -V[level] ] [ -X[a|c|f|r][xshift] ] [ -Y[a|c|f|r][yshift] ] [ --PAR=value ]
必须选项
- nrowsxncols
指定子图的行数和列数。中间为小写英文字母 x，不是星号或其他符号。
每一行和每一列均有相同的子图数目。注意：你无需在每个子图内都绘图。
- -F[f|s]width/height[+fwfracs/hfracs][+cdx/dy][+gfill][+ppen][+wpen]
指定图片的尺寸。有两种方式：
-Ff: 直接指定整张图片的尺寸
-Fs: 指定单个子图的尺寸
除此之外，还可以为整张图加上背景色和边框:
+ppen: 为整张图加上背景矩形边框
+wpen: 绘制子图区域之间的水平和垂直分割线
+gfill: 为整张图的背景矩形填充颜色
+cdx/dy: 设置背景矩形与整张图之间的额外空白
- -F[f]width/height[+fwfracs/hfracs]
指定整张图片的宽度 width 和高度 height。
这种情况下，GMT会根据整张图片的尺寸以及子图的数目自动计算每张子图的尺寸。在计算子图尺寸时会考虑每个子图的刻度线、标注、标签所占据的空间，以及不同子图之间的间隔。整张图的最外圈的刻度线、标记和标签不算在整张图片尺寸之内。
默认所有行和列的尺寸都是相同的。若想要子图的每一行具有不同的高度，或者子图的每一列具有不同的宽度，则可以使用 +f，后面紧跟着一系列逗号分隔的宽度比例和以逗号分隔的高度比例。单个数则表示所有行或列有相同的宽度或高度。
例如，对于一个2x2的子图，使用-Ff12c/12c+f3,1/1,2 则表示
整张图的宽度和高度均为12厘米
第一列占3个宽度，第二列占1个宽度
第一行占1个高度，第二行占2个高度
- -Fswidths/heights
通过指定每个子图的宽度和高度间接指定图片尺寸。
在这种情况下，整张图片的尺寸由每个子图的尺寸以及刻度线、标注、标签占据的空间和子图之间的间隙共同决定，但最外圈的刻度线、标记、标签所占据的空间不算在整张图的尺寸之内。
默认所有行和列的尺寸都是相同的。若想要给每行或每列指定不同的子图尺寸，可以加上一系列以逗号分隔的宽度，然后再加上一个斜杠，并加上一系列以逗号分隔的高度。单个数则表示所有行或列有相同的宽度或高度。
例如，对于一个2x2的子图，使用 -Fs4c,8c/4c 则表示第一列为4厘米宽，第二列为8厘米宽，所有列的高度均为4厘米高。注意，宽度值或高度值的数目必须是一个或者与行数/列数相匹配。
对于地理地图而言，每张子图的高度由地图区域 -R 以及投影方式 -J 决定。有两个选择：(1) 指定子图高度为0，并同时指定 -R 和 -J，利用其计算每张子图的高度，但要求所有子图必须共享相同的研究区域和投影方式；(2) 不断尝试并修改子图的高度以得到最佳的绘图布局。
可选选项
- -A[autolabel][+j|Jrefpoint][+cdx/dy][+gfill][+ppen][+odx/dy][+r][+R][+v]
为子图自动添加编号。
autolabel 可以是单个数字或字母，也可以在数字或字母的一侧或两侧加上括号。其设置了左上角第一张子图的编号，而其余子图则按照递增的顺序依次编号。默认值为 a)。
备注
括号在Unix Shell中有特殊含义，可以将其用单引号括起来，即
'(a)'。加上子选项可以指定编号的更多属性：
- -Bparameters (more …)
设置底图边框和轴属性
- -C[side]clearance
设置子图区域内某个边的额外空白量。这些额外的空白量可以用于绘制比例尺、添加额外的文字等。
side 可以取 e w s n 分别代表东西南北四条边；也可以取 x 或 y，分别表示设置东西或南北方向两条边的空白；若不指定 side，则表示同时设置四条边上的空白量。
该选项可以重复多次，对不同边分别设置不同的间距。
subplot begin 中该选项对所有子图均有效，而 subplot set 中使用该选项则仅对当前子图有效。
- -Jprojection (more …)
设置地图投影方式
- -Mmargins
相邻子图之间的额外空白
margins 可以有三种情况：
取一个值，表示子图四个方向的空白 [默认值为 FONT_ANNOT_PRIMARY 规定的字体大小]
取两个值，表示子图的水平和垂直方向的空白，两个值之间用斜杠分隔
取四个值，表示子图的左右下上四个方向的空白，四个值之间用斜杠分隔
margins 允许设置为负值，进一步缩小子图间距。
- -Rxmin/xmax/ymin/ymax[+r][+uunit] (more …)
指定数据范围
- -SC[b|t][+llabel][+t]
设置一列中的所有子图共用X轴
当一列所有子图共用X轴时，默认只有第一行子图的顶部（t） X轴和最后一个子图的底部（b）X轴有标注。
-SCb 一列中只有最后一行子图的底部X轴有标注
-SCt 一列中只有第一行子图的顶部X轴有标注
+llabel 为共用的X轴添加标注
+t 为每个子图的标题预留空间
+tc 为第一行的所有子图的标题预留空间
- -SR[l|r][+llabel][+p][+t]
设置一行中所有子图共用Y轴
当一行所有子图共用X轴时，默认只有第一列子图的左边Y轴和最后一列子图的右边Y轴有标注。
-SRl 一行中只有第一列子图的左边Y轴有标注
-SRr 一行中只有最后一列子图的右边Y轴有标注
+llabel 为共用的Y轴添加标注
+p 设置所有标注与Y轴平行
- -Theading
设置整张图的总标题，标题文字的属性由 FONT_HEADING 控制。
- -V[level] (more …)
设置 verbose 等级 [w]
-X[a|c|f|r][xshift[u]]
- -Y[a|c|f|r][yshift[u]] (more …)
移动绘图原点
- -^ 或 -
显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）
- -+ 或 +
显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明
- -? 或无参数
显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明
- --PAR=value
临时修改GMT参数的值，可重复多次使用。参数列表见 配置参数
subplot set
subplot set 通过指定子图的行列号或索引号以激活某个特定的子图，接下来的所有绘图命令将只在该子图内进行绘制。其与 -c 选项 功能基本一致。
子图的行号、列号、索引号均从0开始算起。因而对于MxN的子图而言，行号的取值为0到M-1，列号的取值为0到N-1，索引号的取值则为0到(M*N-1)。
若使用 subplot set 但未指定子图的行列号或索引号，则GMT会自动激活“下一个”子图。例如，对于一个2行2列的图而言，每次使用 subplot set 而不指定子图行和列，则按照行优先顺序依次激活子图 0,0 → 0,1 → 1,0 → 1,1。若 subplot begin 中使用了 -A+v 选项，则按照列优先顺序依次激活子图
0,0 → 1,0 → 0,1 → 1,1。
subplot set 语法
gmt subplot set [ row,col|index ] [ -Afixedlabel] [ -Cside/clearance ] [ -V[level] ]
可选选项
- row,col | index
指定要激活的子图的行列号或索引号。行列号、索引号均从0开始算起。
若不指定子图行列号或索引号，则自动激活“下一个”子图。
- -Afixedlabel
设置当前子图的编号，忽略 subplot begin 中 -A 选项设置的自动编号。
这一选项可以用于临时修改单个子图的编号，但该选项只能修改编号字符串，其余属性（如位置、文本框）等均只能继承自 subplot begin 的 -A 选项。
- -Cside/clearance
设置子图的某个边的额外空白量。这些额外的空白量可以用于绘制比例尺、添加额外的文字等。
side 可以取 e w s n 分别代表东西南北四条边。该选项可以重复多次，对不同边分别设置不同的间距。 subplot begin 该选项对所有子图均有效，而 subplot set 中使用该选项则仅对当前子图有效。
subplot end
该命令用于结束当前的子图模式。
在结束子图模式时，其会进行如下操作：
对所有子图进行编号
将绘图原点重置回之前的原点位置
更新历史信息，设置为线性投影，并给出整张图的大小，使得用户可以使用 -DJ 方式放置colorbar等。
subplot end 语法
gmt subplot end [ -V[level] ]
示例
下面的示例展示了如何设置一张2x2布局的图，并使用不同的方式指定要激活的子图。不同的设置方式的效果是相同的，用户在使用时可根据需求选择最直观最简便的方式。
方法1: 使用 subplot set 指定子图行列号
注意行列号均从0开始。
gmt begin map
gmt subplot begin 2x2 -Fs5c/2.5c -A
gmt subplot set 0,0
gmt basemap -R0/10/0/10 -Baf
gmt subplot set 0,1
gmt basemap -R0/10/0/10 -Baf
gmt subplot set 1,0
gmt basemap -R0/10/0/10 -Baf
gmt subplot set 1,1
gmt basemap -R0/10/0/10 -Baf
gmt subplot end
gmt end show
方法2: 使用 subplot set 指定子图索引号
注意子图索引号从0开始:
gmt begin map
gmt subplot begin 2x2 -Fs5c/2.5c -A
gmt subplot set 0
gmt basemap -R0/10/0/10 -Baf
gmt subplot set 1
gmt basemap -R0/10/0/10 -Baf
gmt subplot set 2
gmt basemap -R0/10/0/10 -Baf
gmt subplot set 3
gmt basemap -R0/10/0/10 -Baf
gmt subplot end
gmt end show
方法3: 使用 subplot set 但不指定子图号
每次使用 subplot set 但不指定子图行列号或索引号，则会自动激活“下一个”子图:
gmt begin map
gmt subplot begin 2x2 -Fs5c/2.5c -A
gmt subplot set
gmt basemap -R0/10/0/10 -Baf
gmt subplot set
gmt basemap -R0/10/0/10 -Baf
gmt subplot set
gmt basemap -R0/10/0/10 -Baf
gmt subplot set
gmt basemap -R0/10/0/10 -Baf
gmt subplot end
gmt end show
方法4: 使用 -c 选项
-c 选项 的功能与 subplot set 类似，可以用于激活指定的子图。其后可以接子图行列号或索引号，也可以只使用 -c 自动激活下一个子图:
gmt begin map
gmt subplot begin 2x2 -Fs5c/2.5c -A
gmt basemap -R0/10/0/10 -Baf -c
gmt basemap -R0/10/0/10 -Baf -c
gmt basemap -R0/10/0/10 -Baf -c
gmt basemap -R0/10/0/10 -Baf -c
gmt subplot end
gmt end show
下面展示了如何设置一个2x2的图，并设置共用X和Y轴:
gmt begin panels
gmt subplot begin 2x2 -Fs10c/5c -M5p -A -SCb -SRl -Bwstr -R0/80/0/10
gmt subplot set
gmt basemap
gmt subplot set
gmt basemap
gmt subplot set
gmt basemap
gmt subplot set
gmt basemap
gmt subplot end
gmt end show
下面的示例展示了如何绘制一个不完全规则的子图。这个示例中，实际上只使用了子图0、2、3，而第一张图同时占据了子图0和1的空间。在这种情况下，GMT的自动编号功能无法正确编号，因而需要在 subplot set 中为每个子图单独指定编号。
gmt begin map
gmt subplot begin 2x2 -Fs5c/3c -A -M0
gmt subplot set 0
gmt basemap -R0/20/0/10 -JX11.2c/3c -Baf -BWSen
gmt subplot set 2 -A'(b)'
gmt basemap -R0/20/0/10 -JX? -Baf -BWSen
gmt subplot set 3 -A'(c)'
gmt basemap -R0/20/0/10 -JX? -Baf -BWSen
gmt subplot end
gmt end show
