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 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 inch. 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.
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.)
[20]
ANOT_FONT
Font used for tick mark annotations etc [Helvetica]. Specify
either the font number or the font name. 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 in points for map annotations. [14]
ANOT_OFFSET
Distance from end of tickmark to start of annotation [0.075
inch].
BASEMAP_AXES
Sets which axes to draw and annotate. 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 [0/0/0].
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) [0/0/0].
COLOR_FOREGROUND
Color used for the foreground of images (i.e., when z > highest
colortable entry) [255/255/255].
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) [128/128/128].
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 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 of map borders for FANCY map frame [0.075 inch].
GLOBAL_X_SCALE
Global x-scale 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 of grid cross at lon-lat intersections. 0 means draw
continuous gridlines instead [0 inch].
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.16. 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 for header in points [36].
HSV_MIN_SATURATION
Minimum saturation assigned for most negative intensity value
[1.0].
HSV_MAX_SATURATION
Maximum saturation assigned for most positive intensity value
[0.1].
HSV_MIN_VALUE
Minimum value assigned for most negative intensity value [0.3].
HSV_MAX_VALUE
Maximum value assigned for most positive intensity value [1.0].
INTERPOLANT
Determines if linear (0), Akima's spline (1), or natural cubic
spline (2) should be used for 1-D interpolations in various
programs [1].
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 for labels in points [24].
LINE_STEP
Determines the maximum length of individual straight line-
segments when drawing arcuate lines [0.01 inch]
MAP_SCALE_FACTOR
Sets the central scale factor 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 on the map of the map scalebars drawn by various
programs [0.075 inch].
MEASURE_UNIT
Sets the unit length. Choose between cm, inch, m, and point.
[inch]. 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
[255/255/255].
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 [Letter]. 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 (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.075 inch].
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 [-0.75i/-0.75i].
VECTOR_SHAPE
Determines the shape of the head of a vector. Normally (i.e.,
for vector_shape = 0.0), the head will be triangular, but can be
changed to an arrow (1.0). Intermediate settings gives something
in between [0].
VERBOSE * (-V)
Determines if GMT programs should display run-time information or
run silently.
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 [FALSE].
X_AXIS_LENGTH
Sets the default length of the x-axis [9 inch].
Y_AXIS_LENGTH
Sets the default length of the y-axis [6 inch].
X_ORIGIN * (-X)
Sets the x-coordinate of the origin on the paper for a new plot
[1 inch]. 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
[1 inch]. 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 or vertically
[Horizontally].
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
Man(1) output converted with
man2html