## NAME

           gmtdefaults - To list current GMT defaults

## SYNOPSIS

           gmtdefaults -D[u|s] | -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 >  ~/.gmtde-
           faults  to  get the system settings.  GMT can provide default values in
           US or SI units. This choice  is  determined  by  the  contents  of  the
           gmt.conf file in GMT’s share directory.’

           -D     Print  the  system GMT defaults to standard output. Append u for
                  US defaults or s for SI defaults. [-D alone gives current choice
                  in gmt.conf].

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

## GMT PARAMETERS

           The following is a list of the 58 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  default distances and lengths below are given in both cm or inch;
           the chosen default depends on your choice of  default  unit  (see  MEA-
           SURE_UNIT).  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  base-
                  line  is  less than this minimum value (in degrees), the annota-
                  tion is not plotted (this may occur for certain oblique  projec-
                  tions.) Give a value in the range 0-90. [20]

           ANOT_MIN_SPACING
                  If  an  annotation  would be plotted less than this minimum dis-
                  tance from its closest neighbor, the annotation is  not  plotted
                  (this may occur for certain oblique projections.) [0]

           ANOT_FONT
                  Font  used  for  tick  mark annotations etc [Helvetica]. Specify
                  either the font number or the font name (case  sensitive!).  The
                  39 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
                          35 Ryumin-Light-EUC-H
                          36 Ryumin-Light-EUC-V
                          37 GothicBBB-Medium-EUC-H
                          38 GothicBBB-Medium-EUC-V

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

           ANOT_OFFSET
                  Distance  from  end of tickmark to start of annotation [0.2c (or
                  0.075i)]. A negative offset will place the anotation inside  the
                  map border.

           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.  In general, fancy only applies to situations  where
                  the projected x and y directions parallel the lon and lat direc-
                  tions (e.g., rectangular projections, polar projections).

           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] (white)

           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  dou-
                  ble  precision  floating  point  numbers If it is NOT a ’g’-type
                  format (as the default is), the format is used directly in  ano-
                  tations. [%lg].

           DEGREE_FORMAT
                  Output  format to be used when annotating map boundaries. Choose
                  between 12 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.
                          6 Same as 4, but with letters W, E, S, or N appended  as
                  appropriate.
                          7  Same as 5, but with letters W, E, S, or N appended as
                  appropriate.
                          8 Same as 0, with degrees and decimal minutes instead of
                  degrees, minutes, and seconds.
                          9 Same as 1, with degrees and decimal minutes instead of
                  degrees, minutes, and seconds.
                          10 Same as 2, with degrees and decimal  minutes  instead
                  of degrees, minutes, and seconds.
                          11  Same  as 3, with degrees and decimal minutes instead
                  of degrees, minutes, and seconds.

                  Add 100 to these values to use the large degree symbol character
                  (octal 217) [Default is the small degree symbol (octal 312)].

           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 out-
                  put  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 pro-
                  jections [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  tec-
                  tonics 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.2c  (or
                  0.075i)].

           GLOBAL_X_SCALE
                  Global  x-scale  (> 0) to apply to plot-coordinates before plot-
                  ting. 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].

           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 expan-
                  sion 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 natu-
                  ral 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.025c (or 0.01i)]

           MAP_SCALE_FACTOR
                  Sets  the  central scale factor (> 0) used for the Polar Stereo-
                  graphic 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.2c (or 0.075i)].

           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 defini-
                  tion.

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

           OBLIQUE_ANOTATION
                  This integer is a sum of 5 bit flags (most  of  which  only  are
                  relevant  for oblique projections): If bit 1 is set (1), annota-
                  tions will occur wherever a gridline crosses the map boundaries,
                  else  longitudes will be annotated on the lower and upper bound-
                  aries only, and latitudes will be  annotated  on  the  left  and
                  right  boundaries only. If bit 2 is set (2), then longitude ano-
                  tations will be plotted horizontally. If bit 3 is set (4),  then
                  latitude  anotations  will be plotted horizontally.  If bit 4 is
                  set (8), then oblique tickmarks are extended to give  a  projec-
                  tion  equal to the specified tick_length.  If bit 5 is set (16),
                  tickmarks will be drawn normal to the border regardless of grid-
                  line angle.  To set a combination of these, add up the values in
                  parentheses. [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/share;  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  hex-
                  adecimal  (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.2c (or 0.075i)].

           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 (or -0.75i/-0.75i)].

           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.16 and Appendix H for details [TRUE].

           X_AXIS_LENGTH
                  Sets the default length (> 0) of the x-axis [25c (or 9i)].

           Y_AXIS_LENGTH
                  Sets the default length (> 0) of the y-axis [15c (or 6i)].

           X_ORIGIN * (-X)
                  Sets  the x-coordinate of the origin on the paper for a new plot
                  [2.5c (or 1i)].  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.5c (or 1i)].  For an overlay, the default offset is 0.

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

           Y_AXIS_TYPE
                  Determines  if  the annotations for a y-axis (for linear projec-
                  tions) 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  edi-
           tor 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  warn-
           ing  message  will  be  issued,  and  the GMT defaults for the affected
           parameters will be used.

## SEE ALSO

           gmt(l), gmtset(l)

    GMT3.4.6                          1 Jan 2005                    GMTDEFAULTS(l)