其他参数

本节介绍GMT中的其他参数,参数的默认值在中括号内列出。

数据下载相关参数

GMT_AUTO_DOWNLOAD

是否允许自动从GMT服务器(由 GMT_DATA_SERVER 控制)下载数据文件到用户目录 ~/.gmt 下。可以取 on 或者 off [on]

GMT_DATA_SERVER

GMT数据服务器地址,默认使用SOEST官方镜像 [https://oceania.generic-mapping-tools.org/]

GMT数据服务器目前在全球范围内有多个镜像。详细的镜像列表见 https://www.generic-mapping-tools.org/mirrors 页面。

对于国内用户,建议直接使用中科大LUG提供的国内镜像。修改方式为:

gmt set GMT_DATA_SERVER http://china.generic-mapping-tools.org

然后将生成的 gmt.conf 文件复制到GMT用户目录 ~/.gmt (Linux/macOS) 或 C:\Users\XXX\.gmt (Windows) 下。

GMT_DATA_SERVER_LIMIT

从GMT服务器上下载的单个文件的大小上限,默认无限制。可以给定文件大小上限的字节数,也可以加上 kmg 表示 KB、MB 或 GB。

GMT_DATA_UPDATE_INTERVAL

指定远程数据目录文件的更新频率,默认为1天 [1d]。时间单位可以取 d (天)、w (周)或 o(月)。

算法选择相关参数

GMT_TRIANGULATE

设置 triangulate 模块中算法代码的来源 [Watson]

triangulate 模块的核心源码有两个版本,Watson 的版本遵循GPL,Shewchuk 的版本不遵循GPL。该选项用于控制要使用哪个版本,Shewchuk 版本拥有更多功能。

GMT_FFT

要使用的FFT算法 [auto]

可以取:

  • auto:自动选择合适的算法

  • fftw[,planner_flag]:FFTW算法,其中 planner_flag 可以取 measure|patient|exhaustive

  • accelerate :macOS下使用系统自带的Accelerate Framework(该算法要求采样点数必须为2的n次方)

  • kiss:kiss FFT

  • brenner:Brenner Legacy FFT

GMT_INTERPOLANT

程序中一维插值所使用的算法 [akima]

  • linear:线性插值

  • akima:akima’s spline

  • cubic:natural cubic spline

  • none:不插值

GMT_EXTRAPOLATE_VAL

外插时超过数据区时如何处理 [NaN]

可选值包括:

  • NaN:区域范围外的值一律为NaN

  • extrap: 使用外插算法计算的区域外的值

  • extrapval,val:设置区域外的值为 val

其它参数

GMT_EXPORT_TYPE

控制表数据的数据类型,仅被外部接口使用 [double]

可以取 doublesingle[u]long[u]int[u]short[u]char

GMT_CUSTOM_LIBS

要链接的自定义GMT库文件,默认值为空

GMT支持自定义模块。用户可以写一个GMT模块,并将其编译成动态函数库。通过设置该参数告知GMT该函数库的位置,即可通过 gmt xxx 的语法调用自定义模块,以实现扩充GMT功能的目的。

该参数用于指定自定义动态库函数的路径,多个路径之间用逗号分隔。路径可以是共享库文件的绝对路径,也可以是其所在的目录。若路径是一个目录名,该目录必须需斜杠或反斜杠结尾,表明使用该目录下的全部共享库文件。在Windows下,若目录名是 /,则表示在GMT的bin目录下的 gmt_plugins 子目录下寻找库文件。

GMT_LANGUAGE

设置GMT绘图时使用的语言 [us]

不同的语言中,月份、星期几、东西南北的表达方法是不同的。该参数用于设置GMT绘图时所使用的语言。GMT支持多种语言,各语言的定义文件位于GMT安装目录中 share/localization 目录下的文件。

此处仅列举几个常见语言如下:

  • cn1简体中文

  • cn2繁体中文

  • uk英式英语

  • us美式英语

  • jp日语

  • kr韩语

实际使用时,除了需要修改该参数外,可能还需要修改相应的字符编码和字体。

若设置语言为 cn1 即简体中文并正确设置中文字体,则GMT在绘制时可以显式“一月”、“星期一”、“周一”等中文。相关示例见 GMT中文效果演示

GMT_COMPATIBILITY

是否开启兼容模式 [4]

  • 若值为4,表示兼容GMT4语法并给出警告

  • 若值为5,则表示不兼容GMT4语法,严格遵守GMT5语法,遇到GMT4语法时直接报错

  • 若值为6,表示不兼容GMT5语法

GMT_VERBOSE

控制GMT命令的verbose级别 [warning]

可选值包括

  • quiet

  • error

  • warning

  • timings

  • information

  • compatibility

  • debug

也可以直接使用每个级别的第一个字母。每个级别的具体含义见 -V 选项 一节。

GMT_HISTORY

GMT历史文件 gmt.history 的处理方式 [true]

  • true 可以读写

  • readonly 只能读不能写

  • false 不显示历史文件

GMT_GRAPHICS_FORMAT

现代模式下默认的图片文件格式 [pdf]

GMT_MAX_CORE

多进程并行程序所最多能使用的核数 [0]

默认值0表示尽可能使用所有核