## NAME

          gmtdefaults - To list current GMT defaults

## SYNOPSIS

          gmtdefaults -D | -L

## DESCRIPTION

          gmtdefaults lists the GMT parameter defaults if the option -D is used.
          To change some of the settings, use any texteditor to edit the file
          .gmtdefaults in your home or current directory.  If you do not have
          this file in your home or current directory, run gmtdefaults -D >
          ~/.gmtdefaults to get the system settings.

          -D   Print the system GMT defaults to standard output.

          -L   Print the user's currently active defaults to standard output.

## GMT PARAMETERS

          The following is a list of the 57 parameters that are user-definable
          in GMT.  The parameter names are always given in UPPER CASE.  The
          parameter values are case-insensitive unless otherwise noted.  The
          system defaults are given in brackets [ ].  Those marked * can be set
          on the command line as well (the corresponding option is given in
          parentheses).  Note that distances and lengths below are given in cm.
          You can explicitly specify the unit used for distances and lengths by
          appending c (cm), i (inch), m (meter), or p {points).  When no unit is
          indicated the value will be assumed to be in the unit set by
          MEASURE_UNIT.  Note that the printer resolution DOTS_PR_INCH is always
          the number of dots or pixels per inch.  Several parameters take only
          TRUE or FALSE.

          ANOT_MIN_ANGLE
               If the angle between the map boundary and the annotation baseline
               is less than this minimum value (in degrees), the annotation is
               not plotted (this may occur for certain oblique projections.)
               Give a value in the range 0-90. [20]

          ANOT_FONT
               Font used for tick mark annotations etc [Helvetica].  Specify
               either the font number or the font name (case sensitive!).  The
               35 available fonts are:
                    0  Helvetica
                    1  Helvetica-Bold
                    2  Helvetica-Oblique
                    3  Helvetica-BoldOblique
                    4  Times-Roman
                    5  Times-Bold
                    6  Times-Italic
                    7  Times-BoldItalic
                    8  Courier
                    9  Courier-Bold
                    10 Courier-Oblique
                    11 Courier-BoldOblique
                    12 Symbol
                    13 AvantGarde-Book
                    14 AvantGarde-BookOblique
                    15 AvantGarde-Demi
                    16 AvantGarde-DemiOblique
                    17 Bookman-Demi
                    18 Bookman-DemiItalic
                    19 Bookman-Light
                    20 Bookman-LightItalic
                    21 Helvetica-Narrow
                    22 Helvetica-Narrow-Bold
                    23 Helvetica-Narrow-Oblique
                    24 Helvetica-Narrow-BoldOblique
                    25 NewCenturySchlbk-Roman
                    26 NewCenturySchlbk-Italic
                    27 NewCenturySchlbk-Bold
                    28 NewCenturySchlbk-BoldItalic
                    29 Palatino-Roman
                    30 Palatino-Italic
                    31 Palatino-Bold
                    32 Palatino-BoldItalic
                    33 ZapfChancery-MediumItalic
                    34 ZapfDingbats

          ANOT_FONT_SIZE
               Font size (> 0) in points for map annotations.  [14]

          ANOT_OFFSET
               Distance (> 0) from end of tickmark to start of annotation [0.2
               cm].

          BASEMAP_AXES
               Sets which axes to draw and annotate.  Case sensitive: Upper case
               means both draw and annotate, lower case means draw axis only.
               [WESN].

          BASEMAP_FRAME_RGB
               Color used to draw map boundaries and annotations.  Give a
               red/green/blue triplet, with each element in the 0-255 range.
               [0/0/0] (black).

          BASEMAP_TYPE
               Choose between plain and fancy (thick boundary, alternating
               black/white frame)  [fancy].  For some map projections (e.g.,
               Oblique Mercator), plain is the only option even if fancy is set
               as default.

          COLOR_BACKGROUND
               Color used for the background of images (i.e., when z < lowest
               colortable entry).  Give a red/green/blue triplet, with each
               element in the 0-255 range. [0/0/0] (black)

          COLOR_FOREGROUND
               Color used for the foreground of images (i.e., when z > highest
               colortable entry).  Give a red/green/blue triplet, with each
               element in the 0-255 range. [255/255/255] (write)

          COLOR_IMAGE
               Selects which operator to use when rendering bit-mapped color
               images.  Due to the lack of the colorimage operator in some
               PostScript implementations, GMT offers 2 different options:

                    adobe (Adobe's colorimage definition)  [Default].
                    tiles (Plot image as many individual rectangles).

          COLOR_MODEL
               Selects if color palette files contain rgb values (r,g,b in 0-255
               range) or HSV values (h = 0-360, s,v in 0-1 range)  [rgb].

          COLOR_NAN
               Color used for the non-defined areas of images (i.e., where z ==
               NaN).  Give a red/green/blue triplet, with each element in the
               0-255 range. [128/128/128] (gray)

          D_FORMAT
               Output format (C language syntax) to be used when printing double
               precision floating point numbers  [%lg].

          DEGREE_FORMAT
               Output format to be used when annotating map boundaries.  Choose
               between six formats:

                    0    Longitudes go from 0 to 360, latitudes from -90 to 90
               [Default].
                    1    Longitudes go from -180 to 180, latitudes from -90 to
               90.
                    2    Longitudes are unsigned 0 to 180, latitudes unsigned 0
               to 90.
                    3    Same as 2, but with letters W, E, S, or N appended as
               appropriate.
                    4    Same as 0, with decimal degrees instead of degrees,
               minutes, and seconds.
                    5    Same as 1, with decimal degrees instead of degrees,
               minutes, and seconds.

          DOTS_PR_INCH
               Resolution of the plotting device (dpi).  Note that in order to
               be as compact as possible, GMT PostScript output uses integer
               formats only so the resolution should be set depending on what
               output device you are using.  E.g, using 300 and sending the
               output to a Linotype 300 phototypesetter (2470 dpi) will not take
               advantage of the extra resolution (i.e., positioning on the page
               and line thicknesses are still only done in steps of 1/300 inch;
               of course, text will look smoother)  [300].

          ELLIPSOID
               The (case sensitive) name of the ellipsoid used for the map
               projections  [WGS-84].  Choose among

               WGS-84         1984 World Geodetic System
               GRS-80         1980 International Geodetic Reference System
               WGS-72         1972 World Geodetic System
               WGS-66         1966 World Geodetic System
               Australian     1965 Used down under
               Krassovsky     1940 Used in the Soviet Union
               International  1924 Worldwide use
               Hayford-1909   1909 Same as the International 1924
               Clarke-1880    1880 Most of Africa, France
               Clarke-1866    1866 North America, the Phillipines
               Airy      1830 Great Britain
               Bessel         1841 Central Europe, Chile, Indonesia
               Everest        1830 India, Burma, Pakistan, Afghanistan,
               Thailand, etc.
               Sphere         1980 The mean radius in GRS-80 (for
               spherical/plate tectonics applications)

               Note that for some global projections, GMT may default to GRS-80
               Sphere regardless of ellipsoid actually chosen.  A warning will
               be given when this happens.  If a different ellipsoid name than
               those mentioned here is given, GMT will attempt to open this name
               as a file and read the ellipsoid name, year, major-axis (in m),
               minor-axis (in m), and flattening from the first record, where
               the fields must be separated by white-space (not commas).  This
               way a custom ellipsoid (e.g., those used for other planets) may
               be used.

          FRAME_PEN
               Thickness of pen used to draw plain map frame in dpi units or
               points (append p)  [5].

          FRAME_WIDTH
               Width (> 0) of map borders for fancy map frame [0.2 cm].

          GLOBAL_X_SCALE
               Global x-scale (> 0) to apply to plot-coordinates before
               plotting.  Normally used to shrink the entire output down to fit
               a specific height/width  [1.0].

          GLOBAL_Y_SCALE
               Same, but for y-coordinates  [1.0].

          GRID_CROSS_SIZE
               Size (>= 0) of grid cross at lon-lat intersections.  0 means draw
               continuous gridlines instead [0 cm].

          GRID_PEN
               Pen thickness used to draw grid lines in dpi units or points
               (append p) [1].

          GRIDFILE_SHORTHAND
               If TRUE, all gridfile names are examined to see if they use the
               file extension shorthand discussed in Section 4.17 of the GMT
               Technical Reference and Cookbook.  If FALSE, no filename
               expansion is done [FALSE].

          HEADER_FONT
               Font to use when plotting headers.  See ANOT_FONT for available
               fonts  [Helvetica].

          HEADER_FONT_SIZE
               Font size (> 0) for header in points  [36].

          HSV_MIN_SATURATION
               Minimum saturation (0-1) assigned for most negative intensity
               value [1.0].

          HSV_MAX_SATURATION
               Maximum saturation (0-1) assigned for most positive intensity
               value [0.1].

          HSV_MIN_VALUE
               Minimum value (0-1) assigned for most negative intensity value
               [0.3].

          HSV_MAX_VALUE
               Maximum value (0-1) assigned for most positive intensity value
               [1.0].

          INTERPOLANT
               Determines if linear (linear), Akima's spline (akima), or natural
               cubic spline (cubic) should be used for 1-D interpolations in
               various programs [akima].

          IO_HEADER * (-H)
               Specifies whether input/output ASCII files have header record(s)
               or not  [FALSE].

          N_HEADER_RECS
               Specifies how many header records to expect if -H is turned on
               [1].

          LABEL_FONT
               Font to use when plotting labels below axes.  See ANOT_FONT for
               available fonts  [Helvetica].

          LABEL_FONT_SIZE
               Font size (> 0) for labels in points  [24].

          LINE_STEP
               Determines the maximum length (> 0) of individual straight line-
               segments when drawing arcuate lines  [0.025 cm]

          MAP_SCALE_FACTOR
               Sets the central scale factor (> 0) used for the Polar
               Stereographic and Transverse Mercator projections.  Typically, it
               is set to 0.9996 to minimize areal distortion  [0.9996].

          MAP_SCALE_HEIGHT
               Sets the height (> 0) on the map of the map scalebars drawn by
               various programs [0.2 cm].

          MEASURE_UNIT
               Sets the unit length.  Choose between cm, inch, m, and point.
               [cm].  Note that, in GMT, one point is defined as 1/72 inch (the
               PostScript definition), while it is often defined as 1/72.27 inch
               in the typesetting industry.  There is no universal definition.

          N_COPIES * (-c)
               Number of plot copies to make  [1].

          OBLIQUE_ANOTATION
               This option only applies to oblique projections.  If set to 0,
               longitudes will be annotated on the lower and upper boundaries
               only, and latitudes will be annotated on the left and right
               boundaries only.  1 plots annotations wherever a gridline crosses
               the map boundaries  [1].

          PAGE_COLOR
               Sets the color of the imaging background, i.e., the paper.  Give
               a red/green/blue triplet, with each element in the 0-255 range.
               [255/255/255] (white)

          PAGE_ORIENTATION * (-P)
               Sets the orientation of the page.  Choose portrait or landscape
               [landscape].

          PAPER_MEDIA
               Sets the physical format of the current plot paper [A4].  The
               following formats (and their widths and heights in points) are
               recognized (Additional site-specific formats may be specified in
               the gmtmedia.d file in $GMTHOME/lib; see that file for details):

                    Media     width     height
                    A0   2380 3368
                    A1   1684 2380
                    A2   1190 1684
                    A3   842  1190
                    A4   595  842
                    A5   421  595
                    A6   297  421
                    A7   210  297
                    A8   148  210
                    A9   105  148
                    A10  74   105
                    B0   2836 4008
                    B1   2004 2836
                    B2   1418 2004
                    B3   1002 1418
                    B4   709  1002
                    B5   501  709
                    archA     648  864
                    archB     864  1296
                    archC     1296 1728
                    archD     1728 2592
                    archE     2592 3456
                    flsa 612  936
                    halfletter     396  612
                    note 540  720
                    letter    612  792
                    legal     612  1008
                    11x17     792  1224
                    ledger    1224 792

               To force the printer to request a manual paper feed, append '-'
               to the media name, e.g., A3- will require the user to insert a A3
               paper into the printer's manual feed slot.  To indicate you are
               making an EPS file, append '+' to the media name.  Then, GMT will
               attempt to issue a tight bounding box [Default is the paper
               dimension].

          PSIMAGE_FORMAT
               Determines whether images created in PostScript should use
               hexadecimal (i.e., ascii) or binary format.  The latter takes up
               only half as much space and executes faster but may choke some
               printers, especially those off serial ports.  Select hex or bin
               [hex].

          TICK_LENGTH
               The length of a tickmark.  Normally, tickmarks are drawn on the
               outside of the map boundaries.  To select interior tickmarks, use
               a negative tick_length [0.2 cm].

          TICK_PEN
               The pen thickness to be used for tickmarks in dpi units or points
               (append p) [2].

          UNIX_TIME * (-U)
               Specifies if a UNIX system time stamp should be plotted at the
               lower left corner of the plot  [FALSE].

          UNIX_TIME_POS * (-U)
               Sets the position of the UNIX time stamp relative to the current
               plots lower left corner [-2c/-2c].

          VECTOR_SHAPE
               Determines the shape of the head of a vector.   Normally (i.e.,
               for vector_shape = 0), the head will be triangular, but can be
               changed to an arrow (1).  Intermediate settings gives something
               in between  [0].

          VERBOSE * (-V)
               Determines if GMT programs should display run-time information or
               run silently  [FALSE].

          WANT_EURO_FONT
               Determines if GMT PostScript output should include font re-
               encoding for accented European characters.  See Cookbook section
               4.15 and Appendix H for details [TRUE].

          X_AXIS_LENGTH
               Sets the default length (> 0) of the x-axis [25 cm].

          Y_AXIS_LENGTH
               Sets the default length (> 0) of the y-axis [15 cm].

          X_ORIGIN * (-X)
               Sets the x-coordinate of the origin on the paper for a new plot
               [2.5 cm].  For an overlay, the default offset is 0.

          Y_ORIGIN * (-Y)
               Sets the y-coordinate of the origin on the paper for a new plot
               [2.5 cm].  For an overlay, the default offset is 0.

          XY_TOGGLE * (-:)
               Set if the first two columns of input files contain
               (latitude,longitude) or (y,x) rather than the expected
               (longitude,latitude) or (x,y)  [FALSE].

          Y_AXIS_TYPE
               Determines if the annotations for a y-axis (for linear
               projections) should be plotted horizontally (hor_text) or
               vertically (ver_text)  [hor_text].

## EXAMPLES

          To get a copy of the GMT parameter defaults in your home directory,
          run

          gmtdefaults -D > ~/.gmtdefaults

          You may now change the settings by editing this file using a text
          editor of your choice, or use gmtset to change specified parameters on
          the command line.

## BUGS

          If you have typographical errors in your .gmtdefaults file(s), a
          warning message will be issued, and the GMT defaults for the affected
          parameters will be used.

## SEE ALSO

          gmt, gmtset