NAME

       gmtset - Change individual GMT default parameters

SYNOPSIS

       gmtset [  -C |  -D[s|u] |
        -Gdefaultsfile  ]  [  -[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.  Only parameters that differ
       from the GMT SI system defaults will be written.  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
              just use -).

       -+ 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 all options,
              then exits.

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

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