gmtset man page

gmtset — Change individual GMT default parameters


gmtset [ | [s|u] | defaultsfile ] [ -[BJRXxYycp]value ] PARAMETER1 [=] value1 PARAMETER2 [=] value2 PARAMETER3 [=] value3

Note: No space is allowed between the option flag and the associated arguments.


gmtset will adjust individual GMT defaults settings in the current directory's gmt.conf file. If no such file exists one will be created. The main purpose of gmtset is temporarily to change certain parameters inside a shell script, e.g., set the dots-per-inch to 72, run the script, and reset to 1200 dpi. Optionally, you can specify one or more temporary changes directly on any GMT command line with the syntax --PARAMETER=VALUE; such changes are only in effect for that command and do not permanently change the default settings on disk.

Required Arguments

Provide one or several pairs of parameter/value combinations that you want to modify. For a complete listing of available parameters and their meaning, see the gmt.conf man page.

Optional Arguments

Convert a .gmtdefaults4 file created by GMT4 to a gmt.conf file used by GMT5. The original file is retained.
Modify the GMT defaults based on the system settings. Append u for US defaults or s for SI defaults. [-D alone gives the version selected at compile time]
Name of specific gmt.conf file to read and modify [Default looks first in current directory, then in your home directory, then in ~/.gmt and finally in the system defaults].
Set the expansion of any of these shorthand options.
-^ or just -
Print a short message about the syntax of the command, then exits (NOTE: on Windows use just -).
-+ or just +
Print an extensive usage (help) message, including the explanation of any module-specific option (but not the GMT common options), then exits.
-? or no arguments
Print a complete usage (help) message, including the explanation of options, then exits.
Print GMT version and exit.
Print full path to GMT share directory and exit.


To change annotation font to 12-point Helvetica, select grid-crosses of size 0.1 inch, and set annotation offset to 0.2 cm:

gmt set FONT_ANNOT_PRIMARY 12p,Helvetica \

See Also

gmt, gmt.conf, gmtdefaults, gmtget


GMT 5.2.1 November 12, 2015