1GMTSET(1)                             GMT                            GMTSET(1)
2
3
4

NAME

6       gmtset - Change individual GMT default parameters
7

SYNOPSIS

9       gmtset [  -C |  -D[s|u] |
10        -Gdefaultsfile  ]  [ -[BJRXxYycp]value ] PARAMETER1 [=] value1 PARAME‐
11       TER2 [=] value2 PARAMETER3 [=] value3
12
13       Note: No space is allowed between the option flag  and  the  associated
14       arguments.
15

DESCRIPTION

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

REQUIRED ARGUMENTS

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

OPTIONAL ARGUMENTS

34       -C     Convert  a .gmtdefaults4 file created by GMT4 to a gmt.conf file
35              used by GMT5. The original file is retained.
36
37       -D[s|u]
38              Modify the GMT defaults based on the system settings.  Append  u
39              for  US  defaults or s for SI defaults. [-D alone gives the ver‐
40              sion selected at compile time]
41
42       -Gdefaultsfile
43              Name of specific gmt.conf file to read and modify [Default looks
44              first in current directory, then in your home directory, then in
45              ~/.gmt and finally in the system defaults].
46
47       -[BJRXxYycp]value
48              Set the expansion of any of these shorthand options.
49
50       -^ or just -
51              Print a short message about the  syntax  of  the  command,  then
52              exits (NOTE: on Windows just use -).
53
54       -+ or just +
55              Print  an extensive usage (help) message, including the explana‐
56              tion of any module-specific  option  (but  not  the  GMT  common
57              options), then exits.
58
59       -? or no arguments
60              Print a complete usage (help) message, including the explanation
61              of all options, then exits.
62

EXAMPLES

64       To change annotation font to 12-point Helvetica, select grid-crosses of
65       size 0.1 inch, and set annotation offset to 0.2 cm:
66
67              gmt set FONT_ANNOT_PRIMARY 12p,Helvetica \
68                      MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_ANNOT_OFFSET_PRIMARY 0.2c
69

SEE ALSO

71       gmt, gmt.conf, gmtdefaults, gmtget
72

74       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
75
76
77
78
795.4.5                            Feb 24, 2019                        GMTSET(1)
Impressum