NAME

       gmtset - Change individual GMT default parameters

SYNOPSIS

       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.

DESCRIPTION

       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

       PARAMETER value
              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

       -C     Convert a .gmtdefaults4 file created by GMT4 to a gmt.conf file used by GMT5. The original file is
              retained.

       -D[s|u]
              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]

       -Gdefaultsfile
              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].

       -[BJRXxYycp]value
              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.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.

EXAMPLES

       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 \
                      MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_ANNOT_OFFSET_PRIMARY 0.2c

SEE ALSO

       gmt, gmt.conf, gmtdefaults, gmtget

COPYRIGHT

       2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe

5.2.1                                           January 28, 2016                                    GMTSET(1gmt)