✍️ 田冬冬 , 陈箫翰 , 周茂 • 📅 2026-01-12

# set

官方文档:

  set

简介:

  修改单个或多个GMT配置参数的值

该模块用于修改GMT配置参数的值以调整接下来的绘图或者命令的运行。

该模块修改的参数将对接下来的命令一直有效，直到GMT参数再次被修改或覆盖。 若想要参数修改仅对某个命令有效，可以在该命令中使用 --PARAMETER=value 语法。

## 语法

gmt set [ `-C` | `-D`[s|u] | `-G` defaultsfile ] [ -B|J|R|X|Y|p value ] PARAMETER1 value1 PARAMETER2 value2 PARAMETER3 value3 ...

## 必选选项

PARAMETER value

  要修改的GMT配置参数名 PARAMETER 以及想要设置的值 value

  参数名和值必须成对存在。GMT配置参数见 配置参数。

## 可选选项

-C

-C

  将 GMT4 创建的 GMT4配置文件 `.gmtdefaults4` 转换为GMT5及之后版本所使用的 `gmt.conf` 文件，并保留原GMT4配置文件。

-D

-D[s|u]

  在系统默认配置的基础上修改参数值

  - `-D`：使用GMT编译过程中指定的默认参数文件（通常是SI单位制配置文件）

  - -Du：使用US单位制下的默认参数文件

  - -Ds：使用SI单位制下的默认参数文件

-G

-G defaultsfile

  指定要读取并修改的配置文件名 defaultsfile

-B|J|R|X|Y|p value

  强行修改GMT命令历史文件 gmt.history 中的值。

  GMT在执行一个命令时会在命令历史文件 gmt.history 中记录一些选项的参数值， 使得接下来的命令可以不用再提供这个选项的参数值。 该选项用于在不执行其他绘图命令的前提下强行修改命令历史，但用处不大。

-^ 或 -

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

-+ 或 +

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

-? 或无参数

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

--PAR=value

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

## 示例

访问 设置配置参数 以查看更多示例。

## FAQ

1. 错误消息:

       gmtset: Warning: parameter xxxx is deprecated. Use xxx instead.

   GMT5对所有的配置参数进行了重命令，以使得参数名更容易记忆。出现该报错的原因是， 当前命令使用的是GMT4的老参数名。解决办法是根据警告信息替换为新的GMT5配置参数名。

## 相关模块

defaults, get