1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
|
<HTML>
<HEAD>
<TITLE>gmtdefaults</TITLE>
</HEAD>
<BODY>
<H1>gmtdefaults</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
gmtdefaults - To list current <B><A HREF="GMT.html">GMT</A></B> defaults
</PRE>
<H2>SYNOPSIS</H2><PRE>
<B>gmtdefaults</B> <B>-D</B>[<B>u|s</B>] | <B>-L</B>
</PRE>
<H2>DESCRIPTION</H2><PRE>
<B>gmtdefaults</B> lists the <B><A HREF="GMT.html">GMT</A></B> parameter defaults if the option
<B>-D</B> is used. To change some of the settings, use any texte
ditor to edit the file .gmtdefaults in your home or cur
rent directory. If you do not have this file in your home
or current directory, run <B>gmtdefaults</B> -D > ~/.gmtdefaults
to get the system settings. <B><A HREF="GMT.html">GMT</A></B> can provide default val
ues in US or SI units. This choice is determined by the
contents of the gmt.conf file in GMT's share directory.'
<B>-D</B> Print the system <B><A HREF="GMT.html">GMT</A></B> defaults to standard output.
Append <B>u</B> for US defaults or <B>s</B> for SI defaults. [<B>-D</B>
alone gives current choice in gmt.conf].
<B>-L</B> Print the user's currently active defaults to stan
dard output.'
</PRE>
<H2>GMT PARAMETERS</H2><PRE>
The following is a list of the 58 parameters that are
user-definable in <B><A HREF="GMT.html">GMT</A></B>. The parameter names are always
given in UPPER CASE. The parameter values are case-insen
sitive unless otherwise noted. The system defaults are
given in brackets [ ]. Those marked <B>*</B> 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 MEASURE_UNIT).
You can explicitly specify the unit used for distances and
lengths by appending <B>c</B> (cm), <B>i</B> (inch), <B>m</B> (meter), or <B>p</B>
{points). When no unit is indicated the value will be
assumed to be in the unit set by <B>MEASURE_UNIT</B>. 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.
<B>ANOT_MIN_ANGLE</B>
If the angle between the map boundary and the anno
tation 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]
<B>ANOT_MIN_SPACING</B>
If an annotation would be plotted less than this
minimum distance from its closest neighbor, the
annotation is not plotted (this may occur for cer
tain oblique projections.) [0]
Font used for tick mark annotations etc [Hel
vetica]. 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
<B>ANOT_FONT_SIZE</B>
Font size (> 0) in points for map annotations. [14]
<B>ANOT_OFFSET</B>
Distance from end of tickmark to start of annota
tion [0.2<B>c</B> (or 0.075<B>i</B>)]. A negative offset will
place the anotation inside the map border.
<B>BASEMAP_AXES</B>
lower case means draw axis only. [WESN].
<B>BASEMAP_FRAME_RGB</B>
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).
<B>BASEMAP_TYPE</B>
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 directions (e.g., rectangular projections,
polar projections).
<B>COLOR_BACKGROUND</B>
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)
<B>COLOR_FOREGROUND</B>
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)
<B>COLOR_IMAGE</B>
Selects which operator to use when rendering bit-
mapped color images. Due to the lack of the col
orimage operator in some PostScript implementa
tions, <B><A HREF="GMT.html">GMT</A></B> offers 2 different options:
adobe (Adobe's colorimage definition)
[Default].'
tiles (Plot image as many individual rect
angles).
<B>COLOR_MODEL</B>
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].
<B>COLOR_NAN</B>
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)
<B>D_FORMAT</B>
it is NOT a 'g'-type format (as the default is),
the format is used directly in anotations. [%lg].
<B>DEGREE_FORMAT</B>
Output format to be used when annotating map bound
aries. 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, lati
tudes 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 min
utes instead of degrees, minutes, and seconds.
9 Same as 1, with degrees and decimal min
utes instead of degrees, minutes, and seconds.
10 Same as 2, with degrees and decimal min
utes instead of degrees, minutes, and seconds.
11 Same as 3, with degrees and decimal min
utes 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)].
<B>DOTS_PR_INCH</B>
Resolution of the plotting device (dpi). Note that
in order to be as compact as possible, <B><A HREF="GMT.html">GMT</A></B>
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 resolu
tion (i.e., positioning on the page and line thick
nesses are still only done in steps of 1/300 inch;
of course, text will look smoother) [300].
<B>ELLIPSOID</B>
The (case sensitive) name of the ellipsoid used for
the map projections [WGS-84]. Choose among
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 spheri
cal/plate tectonics applications)
Note that for some global projections, <B><A HREF="GMT.html">GMT</A></B> 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, <B><A HREF="GMT.html">GMT</A></B> 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.
<B>FRAME_PEN</B>
Thickness of pen used to draw plain map frame in
dpi units or points (append p) [5].
<B>FRAME_WIDTH</B>
Width (> 0) of map borders for fancy map frame
[0.2<B>c</B> (or 0.075<B>i</B>)].
<B>GLOBAL_X_SCALE</B>
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].
<B>GLOBAL_Y_SCALE</B>
Same, but for y-coordinates [1.0].
<B>GRID_CROSS_SIZE</B>
Size (>= 0) of grid cross at lon-lat intersections.
0 means draw continuous gridlines instead [0].
<B>GRID_PEN</B>
Pen thickness used to draw grid lines in dpi units
or points (append p) [1].
<B>GRIDFILE_SHORTHAND</B>
Section 4.17 of the GMT Technical Reference and
Cookbook. If FALSE, no filename expansion is done
[FALSE].
<B>HEADER_FONT</B>
Font to use when plotting headers. See ANOT_FONT
for available fonts [Helvetica].
<B>HEADER_FONT_SIZE</B>
Font size (> 0) for header in points [36].
<B>HSV_MIN_SATURATION</B>
Minimum saturation (0-1) assigned for most negative
intensity value [1.0].
<B>HSV_MAX_SATURATION</B>
Maximum saturation (0-1) assigned for most positive
intensity value [0.1].
<B>HSV_MIN_VALUE</B>
Minimum value (0-1) assigned for most negative
intensity value [0.3].
<B>HSV_MAX_VALUE</B>
Maximum value (0-1) assigned for most positive
intensity value [1.0].
<B>INTERPOLANT</B>
Determines if linear (linear), Akima's spline
(akima), or natural cubic spline (cubic) should' be
used for 1-D interpolations in various programs
[akima].
<B>IO_HEADER</B> <B>*</B> <B>(-H)</B>
Specifies whether input/output ASCII files have
header record(s) or not [FALSE].
<B>N_HEADER_RECS</B>
Specifies how many header records to expect if <B>-H</B>
is turned on [1].
<B>LABEL_FONT</B>
Font to use when plotting labels below axes. See
ANOT_FONT for available fonts [Helvetica].
<B>LABEL_FONT_SIZE</B>
Font size (> 0) for labels in points [24].
<B>LINE_STEP</B>
Determines the maximum length (> 0) of individual
straight line-segments when drawing arcuate lines
[0.025<B>c</B> (or 0.01<B>i</B>)]
Sets the central scale factor (> 0) used for the
Polar Stereographic and Transverse Mercator projec
tions. Typically, it is set to 0.9996 to minimize
areal distortion [0.9996].
<B>MAP_SCALE_HEIGHT</B>
Sets the height (> 0) on the map of the map scale
bars drawn by various programs [0.2<B>c</B> (or 0.075<B>i</B>)].
<B>MEASURE_UNIT</B>
Sets the unit length. Choose between cm, inch, m,
and point. [cm]. Note that, in <A HREF="GMT.html">GMT</A>, one point is
defined as 1/72 inch (the <I>PostScript</I> definition),
while it is often defined as 1/72.27 inch in the
typesetting industry. There is no universal defini
tion.
<B>N_COPIES</B> <B>*</B> <B>(-c)</B>
Number of plot copies to make [1].
<B>OBLIQUE_ANOTATION</B>
This integer is a sum of 5 bit flags (most of which
only are relevant for oblique projections): If bit
1 is set (1), annotations will occur wherever a
gridline crosses the map boundaries, else longi
tudes will be annotated on the lower and upper
boundaries only, and latitudes will be annotated on
the left and right boundaries only. If bit 2 is set
(2), then longitude anotations will be plotted hor
izontally. If bit 3 is set (4), then latitude ano
tations will be plotted horizontally. If bit 4 is
set (8), then oblique tickmarks are extended to
give a projection 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].
<B>PAGE_COLOR</B>
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)
<B>PAGE_ORIENTATION</B> <B>*</B> <B>(-P)</B>
Sets the orientation of the page. Choose portrait
or landscape [landscape].
<B>PAPER_MEDIA</B>
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
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].
<B>PSIMAGE_FORMAT</B>
Determines whether images created in PostScript
should use hexadecimal (i.e., ascii) or binary for
mat. 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].
<B>TICK_LENGTH</B>
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<B>c</B> (or 0.075<B>i</B>)].
The pen thickness to be used for tickmarks in dpi
units or points (append p) [2].
<B>UNIX_TIME</B> <B>*</B> <B>(-U)</B>
Specifies if a UNIX system time stamp should be
plotted at the lower left corner of the plot
[FALSE].
<B>UNIX_TIME_POS</B> <B>*</B> <B>(-U)</B>
Sets the position of the UNIX time stamp relative
to the current plots lower left corner [-2<B>c</B>/-2<B>c</B> (or
-0.75<B>i</B>/-0.75<B>i</B>)].
<B>VECTOR_SHAPE</B>
Determines the shape of the head of a vector. Nor
mally (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].
<B>VERBOSE</B> <B>*</B> <B>(-V)</B>
Determines if <B><A HREF="GMT.html">GMT</A></B> programs should display run-time
information or run silently [FALSE].
<B>WANT_EURO_FONT</B>
Determines if <B><A HREF="GMT.html">GMT</A></B> <I>PostScript</I> output should include
font re-encoding for accented European characters.
See Cookbook section 4.16 and Appendix H for
details [TRUE].
<B>X_AXIS_LENGTH</B>
Sets the default length (> 0) of the x-axis [25<B>c</B>
(or 9<B>i</B>)].
<B>Y_AXIS_LENGTH</B>
Sets the default length (> 0) of the y-axis [15<B>c</B>
(or 6<B>i</B>)].
<B>X_ORIGIN</B> <B>*</B> <B>(-X)</B>
Sets the x-coordinate of the origin on the paper
for a new plot [2.5<B>c</B> (or 1<B>i</B>)]. For an overlay, the
default offset is 0.
<B>Y_ORIGIN</B> <B>*</B> <B>(-Y)</B>
Sets the y-coordinate of the origin on the paper
for a new plot [2.5<B>c</B> (or 1<B>i</B>)]. For an overlay, the
default offset is 0.
<B>XY_TOGGLE</B> <B>*</B> <B>(-:)</B>
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].
Determines if the annotations for a y-axis (for
linear projections) should be plotted horizontally
(hor_text) or vertically (ver_text) [hor_text].
</PRE>
<H2>EXAMPLES</H2><PRE>
To get a copy of the <B><A HREF="GMT.html">GMT</A></B> parameter defaults in your home
directory, run
gmtdefaults <B>-D</B> > ~/.gmtdefaults
You may now change the settings by editing this file using
a text editor of your choice, or use <B><A HREF="gmtset.html">gmtset</A></B> to change
specified parameters on the command line.
</PRE>
<H2>BUGS</H2><PRE>
If you have typographical errors in your .gmtdefaults
file(s), a warning message will be issued, and the <B><A HREF="GMT.html">GMT</A></B>
defaults for the affected parameters will be used.
</PRE>
<H2>SEE ALSO</H2><PRE>
<I>gmt</I>(l), <I><A HREF="gmtset.html">gmtset</A></I>(l)
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
<body bgcolor="#ffffff">
|
