gmtwhich

官方文档

gmtwhich

简介

返回指定文件的完整路径

该模块会报告文件的完整路径,使得用户可以确认自己在使用的究竟是哪个数据文件。

GMT 会依次在如下目录中去寻找命令行中指定的文件:当前目录 > GMT 用户目录 > GMT 数据目录 > GMT 缓存目录。可以参考 输入文件的搜索目录 了解每个目录的具体指定方式。

语法

gmt which files [ -A ] [ -C ] [ -D ] [ -G[a|c|l|u] ] [ -V[level] ] [ --PAR=value ]

必选选项

files

任意一个或多个数据文件名

可选选项

-A

仅考虑用户有读权限的文件 [默认不考虑权限问题]

-C

不报告完整路径,只打印 YN 以表示是否找到文件

-D

不报告完整路径,仅打印包含该文件的目录名

-G[a|c|l|u]

自动下载指定的文件。指定下载文件的方式有:

  • URL 链接形式指定的文件:下载到当前目录

  • @filename 形式指定的文件:从 GMT 数据服务器上下载到缓存目录

  • @earth_relief_xxy 形式指定的文件(即 GMT 提供的地学数据集):从 GMT 数据服务器上下载到用户目录下的 server 子目录

使用该选项时,GMT 会先按照 输入文件的搜索目录 中指定的搜索顺序寻找文件,若未找到文件,才会尝试下载该文件:

  • -Gl: 下载到当前目录 [默认选项]

  • -Ga: 下载到用户目录的子目录中,如 servercache 子目录

  • -Gu: 下载到数据目录

  • -Gc: 下载到缓存目录

-V[level] (more …)

设置 verbose 等级 [w]

-^-

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

-++

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

-? 或无参数

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

--PAR=value

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

示例

查看某个文件的路径:

gmt which myjunk.txt

下载并返回GMT提供的10弧分精度的全球地形起伏数据:

gmt which -Ga @earth_relief_10m

从GMT数据服务器下载GMT示例数据。该数据会被下载到GMT缓存目录中(默认为 ~/.gmt/cache):

gmt which -Gc @hotspots.txt