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)

Man(1) output converted with man2html