colorbar

官方文档

colorbar

简介

在地图上绘制灰色或彩色色条

gmt colorbar [ -Bparameters ] [ -Ccpt ] [ -Drefpoint ] [ -Fpanel ] [ -Gzlo/zhi ] [ -I[max_intens|low_i/high_i] ] [ -Jparameters ] [ -Jz|Zparameters ] [ -L[i][gap] ] [ -M ] [ -N[p|dpi ]] [ -Q ] [ -Rregion ] [ -S ] [ -U[stamp] ] [ -V[level] ] [ -Wscale ] [ -X[a|c|f|r][xshift[u]] ] [ -Y[a|c|f|r][xshift[u]] ] [ -Zzfile ] [ -pflags ] [ -ttransp ] [ --PAR=value ]

必选选项

无

可选选项

-B[p|s]parameters

设置colorbar的标注、刻度和网格线间隔。

在不使用 -B 选项或不指定标注间隔时，默认会根据CPT文件中每一行的内容对colorbar进行标注，具体见 CPT文件。-B 选项的具体说明见 -B 选项。

默认情况下，对于水平colorbar而言，X轴的标签会放在colorbar的下边，Y轴标签放在 colorbar的右边；对于垂直colorbar而言，X轴的标签放在colorbar的右边，Y轴标签放在colorbar的上边。除非在 -D 选项中使用了 +m 子选项。

-C[cpt]

要绘制的CPT文件。

若CPT中Z值范围单位为米，而实际绘图时想使用其它单位，则可在文件名后加上 +Uunit。若CPT中Z值范围单位不为米，而实际绘图中想使用米为单位，则可在文件名后加上 +uunit。

对于现代模式，若未指定 cpt 或者未使用 -C 选项，则使用当前CPT。经典模式下，若未指定 -C 则从标准输入中读入CPT。

-D[g|j|J|n|x]refpoint[+wlength[/width]][+e[b|f][length]][+h|v][+jjustify][+m[a|c|l|u]][+n[txt]][+odx[/dy]]

指定色标的尺寸和位置。

简单介绍各子选项的含义，详情见 修饰物

  • g|j|J|n|x]refpoint指定地图上的参考点

    • g 指定某地图坐标位参考点

    • j|J 通过2字母的对齐方式码指定矩形区域的某个锚点作为参考点

    • n 在归一化坐标系（即0-1）中指定参考点

    • x 在绘图坐标系下指定参考点

  • +jjustify 指定色标上的锚点，默认锚点是 BL

  • +odx/dy 在参考点的基础上设置色标的额外偏移量

  • +wlength[/width] 指定色标的长度和宽度。若未指定宽度，则默认为长度的4%；若长度为负值则会反转色标。

  • +h 绘制水平色标

  • +v 绘制垂直色标

  • +e[b|f][length] 在CPT中为前景色和背景色加一个三角形。 +ef 表示只加前景色三角形， +eb 表示只加背景色三角形 length 是三角的高度，默认为色标宽度的一半。

  • +m[a|c|l|u] 将标注、标签和单位放在色标的另一边。 a 代表标注， l 代表标签， u 代表单位。 c 表示将标签以单列字符垂直打印。

  • +ntext 在色标开始处绘制一个矩形，并用NaN的颜色填充

几种常用的放置色标的方式：

  • 放在左边: -DjML+w2c/0.5c+o-1c/0c+m

  • 放在右边: -DjMR+w2c/0.5c+o-1c/0c

  • 放在上方: -DjTC+w2c/0.5c+o0c/-1c+m

  • 放在下方: -DjBC+w2c/0.5c+o0c/-1c+m

  • 放在左上角: -DjTL+w2c/0.5c+o-1c/0c+m

  • 放在左下角: -DjBL+w2c/0.5c+o-1c/0c+m

  • 放在右上角: -DjTR+w2c/0.5c+o-1c/0c

  • 放在右下角: -DjBR+w2c/0.5c+o-1c/0c

-F[+cclearances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]

控制色标后的背景边框

若只使用 -F 而不使用其它子选项，则会在色标周围绘制矩形边框。下面简单介绍各子选项，详细用法见 修饰物

  • +ppen 指定背景面板的画笔属性（默认画笔属性由 MAP_FRAME_PEN 决定）

  • +gfill 设置背景面板的填充色 [默认不填充]

  • +cclearances 以设置不同方向的空白间隔

  • +igap/pen 在背景面板内部绘制一个额外的内边框。gap 为外边框与内边界之间的距离 [2p]，默认边界属性由 MAP_DEFAULT_PEN 控制

  • +rradius 控制圆角矩形边框，圆角矩形半径 radius 默认为 6p

  • +s 绘制背景面板阴影区。dx/dy 是阴影区相对于背景面板的偏移量 [4p/4p]。 shade 为阴影区的颜色 [gray50]。

-Gzlow/zhigh

对CPT文件做截断，即只绘制 zlow 到 zhigh 之间的部分。若其中某个值等于NaN，则不对CPT的那一端做处理。

-I[max_intens|low_i/high_i]

为色标加上光照效果

  • -Imax_intens 设置光照强度为 [-max_intens, +max_intens]，默认值为[-1,+1]

  • -Ilow_i/high_i 指定非对称的光照强度范围

-Jprojection (more …)

设置地图投影方式

-L[i][gap]

生成等大小的颜色矩形。

默认情况下，会根据CPT文件中Z值的范围决定颜色矩形的大小。若使用该选项，则会忽略 -B 选项设置的间隔。若指定了 gap 且CPT文件是离散的，则使用每个矩形的Z值下边界作为标注且将标注放在矩形的正中间。若使用了 i 则标注每个间隔范围。若使用了 -I 选项，则每个矩形有自己的颜色以及自己的光照强度。

-M

使用YIQ变换将色标变成单调灰度色标

-N[p|dpi]

控制色标的图形表示方式

  • -Np 用颜色矩形来表示（比如离散的颜色）

  • -N 用图形表示（比如连续的颜色），可以加上 dpi 指定绘制色标时的等效DPI，默认值为600

-Q

使用对数坐标，刻度表示为10的次幂

CPT文件中所有的Z值都会被转换成 \(p = \log10(z)\)，其中整数的p会以10^p的格式标注。

-Rxmin/xmax/ymin/ymax[+r][+uunit] (more …)

指定数据范围

-S

去除不同色块之间的黑色网格线

-U[label][+c][+jjust][+odx/dy] (more …)

在图上绘制GMT时间戳logo

-V[level] (more …)

设置 verbose 等级 [w]

-Wscale

将CPT文件中所有的Z值乘以比例因子 scale

-X[a|c|f|r][xshift[u]]

-Y[a|c|f|r][yshift[u]] (more …)

移动绘图原点

-Zzfile

zfile 文件用于指定每个颜色块的宽度。

默认情况下，颜色块的宽度由颜色的Z值范围决定，比如Z=0-100对应的色块宽度是 Z=100-150的色块宽度的两倍。

-p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more …)

设置3D透视视角

-t[transp] (more …)

设置图层透明度（百分比）。取值范围为0（不透明）到100（全透明）

-^ 或 -

显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）

-+ 或 +

显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明

-? 或无参数

显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明

--PAR=value

临时修改GMT参数的值，可重复多次使用。参数列表见 gmt.conf

示例

gmt begin map
gmt makecpt -T-200/1000/100 -Crainbow
gmt colorbar -C -Dx8c/1c+w12c/0.5c+jTC+h -Bxaf+l"topography" -By+lkm
gmt end