1GMTDEFAULTS(1) Generic Mapping Tools GMTDEFAULTS(1)
2
6 gmtdefaults - To list current GMT defaults
7
9 gmtdefaults -D[u|s] | -L
10
12 gmtdefaults lists the GMT parameter defaults if the option -D is used.
13 There are three ways to change some of the settings: (1) Use the com‐
14 mand gmtset, (2) use any texteditor to edit the file .gmtdefaults4 in
15 your home, ~/.gmt or current directory (if you do not have this file,
16 run gmtdefaults -D > ~/.gmtdefaults4 to get one with the system default
17 settings), or (3) override any parameter by specifying one or more
18 --PARAMETER=VALUE statements on the commandline of any GMT command
19 (PARAMETER and VALUE are any combination listed below). The first two
20 options are permanent changes until explicitly changed back, while the
21 last option is emphemeral and only applies to the single GMT command
22 that received the override. GMT can provide default values in US or SI
23 units. This choice is determined by the contents of the gmt.conf file
24 in GMT's share directory.
25 -D Print the system GMT defaults to standard output. Append u for
27 US defaults or s for SI defaults. [-D alone gives current choice
28 in gmt.conf].
29 -L Print the user's currently active defaults to standard output.
31 Your currently active defaults come from the .gmtdefaults4 file
33 in the current working directory, if present; else from the
34 .gmtdefaults4 file in your home directory, if present; else from
35 the file ~/.gmt/.gmtdefaults4, if present; else from the system
36 defaults set at the time GMT was compiled.
37
39 The following is a list of the parameters that are user-definable in
40 GMT. The parameter names are always given in UPPER CASE. The parame‐
41 ter values are case-insensitive unless otherwise noted. The system
42 defaults are given in brackets [ for SI (and US) ]. Those marked * can
43 be set on the command line as well (the corresponding option is given
44 in parentheses). Note that default distances and lengths below are
45 given in both cm or inch; the chosen default depends on your choice of
46 default unit (see MEASURE_UNIT). You can explicitly specify the unit
47 used for distances and lengths by appending c (cm), i (inch), m
48 (meter), or p (points). When no unit is indicated the value will be
49 assumed to be in the unit set by MEASURE_UNIT. Note that the printer
50 resolution DOTS_PR_INCH is always the number of dots or pixels per
51 inch. Several parameters take only TRUE or FALSE.
52 ANNOT_MIN_ANGLE
54 If the angle between the map boundary and the annotation base‐
55 line is less than this minimum value (in degrees), the annota‐
56 tion is not plotted (this may occur for certain oblique projec‐
57 tions.) Give a value in the range 0-90. [20]
58 ANNOT_MIN_SPACING
60 If an annotation would be plotted less than this minimum dis‐
61 tance from its closest neighbor, the annotation is not plotted
62 (this may occur for certain oblique projections.) [0]
63 ANNOT_FONT_PRIMARY
65 Font used for upper annotations, etc. [Helvetica]. Specify
66 either the font number or the font name (case sensitive!). The
67 35 available fonts are:
68 0 Helvetica
69 1 Helvetica-Bold
70 2 Helvetica-Oblique
71 3 Helvetica-BoldOblique
72 4 Times-Roman
73 5 Times-Bold
74 6 Times-Italic
75 7 Times-BoldItalic
76 8 Courier
77 9 Courier-Bold
78 10 Courier-Oblique
79 11 Courier-BoldOblique
80 12 Symbol
81 13 AvantGarde-Book
82 14 AvantGarde-BookOblique
83 15 AvantGarde-Demi
84 16 AvantGarde-DemiOblique
85 17 Bookman-Demi
86 18 Bookman-DemiItalic
87 19 Bookman-Light
88 20 Bookman-LightItalic
89 21 Helvetica-Narrow
90 22 Helvetica-Narrow-Bold
91 23 Helvetica-Narrow-Oblique
92 24 Helvetica-Narrow-BoldOblique
93 25 NewCenturySchlbk-Roman
94 26 NewCenturySchlbk-Italic
95 27 NewCenturySchlbk-Bold
96 28 NewCenturySchlbk-BoldItalic
97 29 Palatino-Roman
98 30 Palatino-Italic
99 31 Palatino-Bold
100 32 Palatino-BoldItalic
101 33 ZapfChancery-MediumItalic
102 34 ZapfDingbats
103 ANNOT_FONT_SIZE_PRIMARY
105 Font size (> 0) in points for map annotations. [14]
106 ANNOT_FONT_SECONDARY
108 Font to use for time axis secondary annotations. See
109 ANNOT_FONT_PRIMARY for available fonts [Helvetica].
110 ANNOT_FONT_SIZE_SECONDARY
112 Font size (> 0) for time axis secondary annotations in points
113 [16].
114 ANNOT_OFFSET_PRIMARY
116 Distance from end of tickmark to start of annotation [0.2c (or
117 0.075i)]. A negative offset will place the annotation inside
118 the map border.
119 ANNOT_OFFSET_SECONDARY
121 Distance from base of primary annotation to the top of the sec‐
122 ondary annotation [0.2c (or 0.075i)] (Only applies to time axes
123 with both primary and secondary annotations).
124 BASEMAP_AXES
126 Sets which axes to draw and annotate. Case sensitive: Upper
127 case means both draw and annotate, lower case means draw axis
128 only. [WESN].
129 BASEMAP_FRAME_RGB
131 Color used to draw map boundaries and annotations. Give a
132 red/green/blue triplet, with each element in the 0-255 range.
133 Prepend '+' to replicate this color to the tick-, grid-, and
134 frame-pens. [0/0/0] (black).
135 BASEMAP_TYPE
137 Choose between plain and fancy (thick boundary, alternating
138 black/white frame; append + for rounded corners) [fancy]. For
139 some map projections (e.g., Oblique Mercator), plain is the only
140 option even if fancy is set as default. In general, fancy only
141 applies to situations where the projected x and y directions
142 parallel the lon and lat directions (e.g., rectangular projec‐
143 tions, polar projections).
144 CHAR_ENCODING
146 Names the eight bit character set being used for text in files
147 and in command line parameters. This allows GMT to ensure that
148 the PostScript output generates the correct characters on the
149 plot.. Choose from Standard, Standard+, ISOLatin1, ISOLatin1+,
150 and ISO-8859-x (where x is in the ranges 1-10 or 13-15). See
151 Appendix F for details [ISOLatin1+ (or Standard+)].
152 COLOR_BACKGROUND
154 Color used for the background of images (i.e., when z < lowest
155 colortable entry). Give a red/green/blue triplet, with each
156 element in the 0-255 range. [0/0/0] (black)
157 COLOR_FOREGROUND
159 Color used for the foreground of images (i.e., when z > highest
160 colortable entry). Give a red/green/blue triplet, with each
161 element in the 0-255 range. [255/255/255] (white)
162 COLOR_IMAGE
164 Selects which operator to use when rendering bit-mapped color
165 images. Due to the lack of the colorimage operator in some
166 PostScript implementations, as well as some PostScript editors
167 inability to handle color gradations, GMT offers two different
168 options:
169 adobe (Adobe's colorimage definition) [Default].
171 tiles (Plot image as many individual rectangles).
172 COLOR_MODEL
174 Selects if color palette files contain RGB values (r,g,b in
175 0-255 range), HSV values (h in 0-360, s,v in 0-1 range), or CMYK
176 values (c,m,y,k in 0-1 range). A COLOR_MODEL setting in the
177 color palette file will override this setting. Internally,
178 color interpolation takes place directly on the RGB values which
179 can give unexpected hues, whereas interpolation directly on the
180 HSV values better preserves the hues. Prepend the prefix "+" to
181 force interpolation in the selected color system (does not apply
182 to the CMYK system). For this additional option, the defaults
183 take precedence over the color palette file [rgb].
184 COLOR_NAN
186 Color used for the non-defined areas of images (i.e., where z ==
187 NaN). Give a red/green/blue triplet, with each element in the
188 0-255 range. [128/128/128] (gray)
189 D_FORMAT
191 Output format (C language printf syntax) to be used when print‐
192 ing double precision floating point numbers. For geographic
193 coordinates, see OUTPUT_DEGREE_FORMAT. [%g].
194 DEGREE_SYMBOL
196 Determines what symbol is used to plot the degree symbol on geo‐
197 graphic map annotations. Choose between ring, degree, colon, or
198 none [ring].
199 DOTS_PR_INCH
201 Resolution of the plotting device (dpi). Note that in order to
202 be as compact as possible, GMT PostScript output uses integer
203 formats only so the resolution should be set depending on what
204 output device you are using. E.g, using 300 and sending the
205 output to a Linotype 300 phototypesetter (2470 dpi) will not
206 take advantage of the extra resolution (i.e., positioning on the
207 page and line thicknesses are still only done in steps of 1/300
208 inch; of course, text will look smoother) [300].
209 ELLIPSOID
211 The (case sensitive) name of the ellipsoid used for the map pro‐
212 jections [WGS-84]. Choose among
213 WGS-84 1984 World Geodetic System [Default]
215 OSU91A 1991 Ohio State University
216 OSU86F 1986 Ohio State University
217 Engelis 1985 Goodard Earth Models
218 SGS-85 1985 Soviet Geodetic System
219 MERIT-83 1983 United States Naval Observatory
220 GRS-80 1980 International Geodetic Reference System
221 Hughes-1980 1980 Hughes Aircraft Company for DMSP SSM/I grid
222 products
223 Lerch 1979 For geoid modelling
224 ATS77 1977 Average Terrestrial System, Canada Maritime prov‐
225 inces
226 IAG-75 1975 International Association of Geodesy
227 Indonesian 1974 Applies to Indonesia
228 WGS-72 1972 World Geodetic System
229 NWL-10D 1972 Naval Weapons Lab (Same as WGS-72)
230 South-American 1969 Applies to South America
231 Fischer-1968 1968 Used by NASA for Mercury program
232 Modified-Mercury-1968 1968 Same as Fischer-1968
233 GRS-67 1967 International Geodetic Reference System
234 International-1967 1967 Worldwide use
235 WGS-66 1966 World Geodetic System
236 NWL-9D 1966 Naval Weapons Lab (Same as WGS-66)
237 Australian 1965 Applies to Australia
238 APL4.9 1965 Appl. Physics
239 Kaula 1961 From satellite tracking
240 Hough 1960 Applies to the Marshall Islands
241 WGS-60 1960 World Geodetic System
242 Fischer-1960 1960 Used by NASA for Mercury program
243 Mercury-1960 1960 Same as Fischer-1960
244 Modified-Fischer-1960 1960 Applies to Singapore
245 Fischer-1960-SouthAsia 1960 Same as Modified-Fischer-1960
246 Krassovsky 1940 Used in the (now former) Soviet Union
247 War-Office 1926 Developed by G. T. McCaw
248 International-1924 1924 Worldwide use
249 Hayford-1909 1909 Same as the International 1924
250 Helmert-1906 1906 Applies to Egypt
251 Clarke-1880 1880 Applies to most of Africa, France
252 Clarke-1880-Arc1950 1880 Modified Clarke-1880 for Arc 1950
253 Clarke-1880-IGN 1880 Modified Clarke-1880 for IGN
254 Clarke-1880-Jamaica 1880 Modified Clarke-1880 for Jamaica
255 Clarke-1880-Merchich 1880 Modified Clarke-1880 for Merchich
256 Clarke-1880-Palestine 1880 Modified Clarke-1880 for Palestine
257 Andrae 1876 Applies to Denmark and Iceland
258 Clarke-1866 1866 Applies to North America, the Philippines
259 Clarke-1866-Michigan 1866 Modified Clarke-1866 for Michigan
260 Struve 1860 Friedrich Georg Wilhelm Struve
261 Clarke-1858 1858 Clarke's early ellipsoid
262 Airy 1830 Applies to Great Britain
263 Airy-Ireland 1830 Applies to Ireland in 1965
264 Modified-Airy 1830 Same as Airy-Ireland
265 Bessel 1841 Applies to Central Europe, Chile, Indonesia
266 Bessel-Schwazeck 1841 Applies to Namibia
267 Bessel-Namibia 1841 Same as Bessel-Schwazeck
268 Bessel-NGO1948 1841 Modified Bessel for NGO 1948
269 Everest-1830 1830 India, Burma, Pakistan, Afghanistan, Thai‐
270 land
271 Everest-1830-Kalianpur 1830 Modified Everest for Kalianpur
272 (1956)
273 Everest-1830-Kertau 1830 Modified Everest for Kertau, Malaysia &
274 Singapore
275 Everest-1830-Timbalai 1830 Modified Everest for Timbalai,
276 Sabah Sarawak
277 Everest-1830-Pakistan 1830 Modified Everest for Pakistan
278 Walbeck 1819 First least squares solution by Finnish
279 astronomer
280 Plessis 1817 Old ellipsoid used in France
281 Delambre 1810 Applies to Belgium
282 CPM 1799 Comm. des Poids et Mesures, France
283 Maupertius 1738 Really old ellipsoid used in France
284 Sphere 1984 The mean (authalic) radius in WGS-84 (for spheri‐
285 cal/plate tectonics applications)
286 Note that for some global projections, GMT may default to GRS-80
288 Sphere regardless of ellipsoid actually chosen. A warning will
289 be given when this happens. If a different ellipsoid name than
290 those mentioned here is given, GMT will attempt to open a file
291 with that name in the current directory, and read a single
292 record that contains the ellipsoid name, year, major-axis (in
293 m), minor-axis (in m), and flattening (f) from the first record,
294 where the fields must be separated by white-space (not commas).
295 This way a custom ellipsoid (e.g., those used for other planets)
296 may be used. A negative flattening means GMT will recalculate
297 flattening from the two radii. Further note that coordinate
298 transformations in mapproject can also specify specific datums;
299 see the mapproject man page for further details and how to view
300 ellipsoid and datum parameters.
301 FIELD_DELIMITER
303 This setting determines what character will separate ASCII out‐
304 put data columns written by GMT. Choose from tab, space, comma,
305 and none [tab].
306 FRAME_PEN
308 Thickness of pen used to draw plain map frame in dpi units or
309 points (append p) [1.25p].
310 FRAME_WIDTH
312 Width (> 0) of map borders for fancy map frame [0.2c (or
313 0.075i)].
314 GLOBAL_X_SCALE
316 Global x-scale (> 0) to apply to plot-coordinates before plot‐
317 ting. Normally used to shrink the entire output down to fit a
318 specific height/width [1.0].
319 GLOBAL_Y_SCALE
321 Same, but for y-coordinates [1.0].
322 GRID_CROSS_SIZE_PRIMARY
324 Size (>= 0) of grid cross at lon-lat intersections. 0 means
325 draw continuous gridlines instead [0].
326 GRID_PEN_PRIMARY
328 Pen thickness used to draw grid lines in dpi units or points
329 (append p) [0.25p].
330 GRID_CROSS_SIZE_SECONDARY
332 Size (>= 0) of grid cross at secondary lon-lat intersections. 0
333 means draw continuous gridlines instead [0].
334 GRID_FORMAT
336 Default file format for grids, with optional scale, offset and
337 invalid value, written as ff/scale/offset/invalid. The 2-letter
338 format indicator can be one of [bcnsr][bsifd]. The first letter
339 indicates native GMT binary, old format netCDF, COARDS-compliant
340 netCDF, Surfer format or Sun Raster format. The second letter
341 stands for byte, short, int, float and double, respectively.
342 When /invalid is omitted the appropriate value for the given
343 format is used (NaN or largest negative). When /scale/offset is
344 omitted, /1.0/0.0 is used. [nf].
345 GRID_PEN_SECONDARY
347 Pen thickness used to draw grid lines in dpi units or points
348 (append p) [0.5p].
349 GRIDFILE_SHORTHAND
351 If TRUE, all grid file names are examined to see if they use the
352 file extension shorthand discussed in Section 4.17 of the GMT
353 Technical Reference and Cookbook. If FALSE, no filename expan‐
354 sion is done [FALSE].
355 HEADER_FONT
357 Font to use when plotting headers. See ANNOT_FONT_PRIMARY for
358 available fonts [Helvetica].
359 HEADER_FONT_SIZE
361 Font size (> 0) for header in points [36].
362 HEADER_OFFSET
364 Distance from top of axis annotations (or axis label, if
365 present) to base of plot header [0.5c (or 0.1875i)].
366 HISTORY
368 If TRUE, passes the history of past common command options via
369 the hidden .gmtcommands4 file [TRUE].
370 HSV_MIN_SATURATION
372 Minimum saturation (0-1) assigned for most negative intensity
373 value [1.0].
374 HSV_MAX_SATURATION
376 Maximum saturation (0-1) assigned for most positive intensity
377 value [0.1].
378 HSV_MIN_VALUE
380 Minimum value (0-1) assigned for most negative intensity value
381 [0.3].
382 HSV_MAX_VALUE
384 Maximum value (0-1) assigned for most positive intensity value
385 [1.0].
386 INPUT_CLOCK_FORMAT
388 Formatting template that indicates how an input clock string is
389 formatted. This template is then used to guide the reading of
390 clock strings in data fields. To properly decode 12-hour
391 clocks, append am or pm (or upper case) to match your data
392 records. As examples, try hh:mm, hh:mm:ssAM, etc. [hh:mm:ss].
393 INPUT_DATE_FORMAT
395 Formatting template that indicates how an input date string is
396 formatted. This template is then used to guide the reading of
397 date strings in data fields. You may specify either Gregorian
398 calendar format or ISO week calendar format. Gregorian calen‐
399 dar: Use any combination of yyyy (or yy for 2-digit years; if so
400 see Y2K_OFFSET_YEAR), mm (or o for abbreviated month name in the
401 current time language), and dd, with or without delimiters. For
402 day-of-year data, use jjj instead of mm and/or dd. Examples can
403 be ddmmyyyy, yy-mm-dd, dd-o-yyyy, yyyy/dd/mm, yyyy-jjj, etc.
404 ISO Calendar: Expected template is yyyy[-]W[-]ww[-]d, where ww
405 is ISO week and d is ISO week day. Either template must be con‐
406 sistent, e.g., you cannot specify months if you don't specify
407 years. Examples are yyyyWwwd, yyyy-Www, etc. [yyyy-mm-dd].
408 INTERPOLANT
410 Determines if linear (linear), Akima's spline (akima), natural
411 cubic spline (cubic) or no interpolation (none) should be used
412 for 1-D interpolations in various programs [akima].
413 IO_HEADER
415 (* -H) Specifies whether input/output ASCII files have header
416 record(s) or not [FALSE].
417 N_HEADER_RECS
419 Specifies how many header records to expect if -H is turned on
420 [1].
421 LABEL_FONT
423 Font to use when plotting labels below axes. See
424 ANNOT_FONT_PRIMARY for available fonts [Helvetica].
425 LABEL_FONT_SIZE
427 Font size (> 0) for labels in points [24].
428 LABEL_OFFSET
430 Distance from base of axis annotations to the top of the axis
431 label [0.3c (or 0.1125i)].
432 LINE_STEP
434 Determines the maximum length (> 0) of individual straight line-
435 segments when drawing arcuate lines [0.025c (or 0.01i)]
436 MAP_SCALE_FACTOR
438 Changes the default map scale factor used for the Polar Stereo‐
439 graphic [0.9996], UTM [0.9996], and Transverse Mercator [1] pro‐
440 jections in order to minimize areal distortion. Provide a new
441 scale-factor or leave as default.
442 MAP_SCALE_HEIGHT
444 Sets the height (> 0) on the map of the map scale bars drawn by
445 various programs [0.2c (or 0.075i)].
446 MEASURE_UNIT
448 Sets the unit length. Choose between cm, inch, m, and point.
449 [cm]. Note that, in GMT, one point is defined as 1/72 inch (the
450 PostScript definition), while it is often defined as 1/72.27
451 inch in the typesetting industry. There is no universal defini‐
452 tion.
453 N_COPIES
455 (* -c) Number of plot copies to make [1].
456 OBLIQUE_ANNOTATION
458 This integer is a sum of 6 bit flags (most of which only are
459 relevant for oblique projections): If bit 1 is set (1), annota‐
460 tions will occur wherever a gridline crosses the map boundaries,
461 else longitudes will be annotated on the lower and upper bound‐
462 aries only, and latitudes will be annotated on the left and
463 right boundaries only. If bit 2 is set (2), then longitude
464 annotations will be plotted horizontally. If bit 3 is set (4),
465 then latitude annotations will be plotted horizontally. If bit
466 4 is set (8), then oblique tickmarks are extended to give a pro‐
467 jection equal to the specified tick_length. If bit 5 is set
468 (16), tickmarks will be drawn normal to the border regardless of
469 gridline angle. If bit 6 is set (32), then latitude annotations
470 will be plotted parallel to the border. To set a combination of
471 these, add up the values in parentheses. [1].
472 OUTPUT_CLOCK_FORMAT
474 Formatting template that indicates how an output clock string is
475 to be formatted. This template is then used to guide the writ‐
476 ing of clock strings in data fields. To use a floating point
477 format for the smallest unit (e.g. seconds), append .xxx, where
478 the number of x indicates the desired precision. If no floating
479 point is indicated then the smallest specified unit will be
480 rounded off to nearest integer. For 12-hour clocks, append am,
481 AM, a.m., or A.M. (GMT will replace a|A with p|P for pm). If
482 your template starts with a leading hyphen (-) then each integer
483 item (y,m,d) will be printed without leading zeros (default uses
484 fixed width formats). As examples, try hh:mm, hh.mm.ss,
485 hh:mm:ss.xxxx, hha.m., etc. [hh:mm:ss].
486 OUTPUT_DATE_FORMAT
488 Formatting template that indicates how an output date string is
489 to be formatted. This template is then used to guide the writ‐
490 ing of date strings in data fields. You may specify either Gre‐
491 gorian calendar format or ISO week calendar format. Gregorian
492 calendar: Use any combination of yyyy (or yy for 2-digit years;
493 if so see Y2K_OFFSET_YEAR), mm (or o for abbreviated month name
494 in the current time language), and dd, with or without delim‐
495 iters. For day-of-year data, use jjj instead of mm and/or dd.
496 As examples, try yy/mm/dd, yyyy=jjj, dd-o-yyyy, dd-mm-yy, yy-mm,
497 etc. ISO Calendar: Expected template is yyyy[-]W[-]ww[-]d,
498 where ww is ISO week and d is ISO week day. Either template
499 must be consistant, e.g., you cannot specify months if you don't
500 specify years. As examples, try yyyyWww, yy-W-ww-d, etc. If
501 your template starts with a leading hyphen (-) then each integer
502 item (y,m,d) will be printed without leading zeros (default uses
503 fixed width formats) [yyyy-mm-dd].
504 OUTPUT_DEGREE_FORMAT
506 Formatting template that indicates how an output geographical
507 coordinate is to be formatted. This template is then used to
508 guide the writing of geographical coordinates in data fields.
509 The template is in general of the form [+|-]D or
510 [+|-]ddd[:mm[:ss]][.xxx][F]. The various terms have the follow‐
511 ing purpose:
512 + means output longitude in the 0 to 360 range [-180/+180]
514 - means output longitude in the -360 to 0 range [-180/+180]
515 D Use D_FORMAT for floating point degrees.
516 ddd Fixed format integer degrees
517 : delimiter used
518 mm Fixed format integer arc minutes
519 ss Fixed format integer arc seconds
520 F Encode sign using WESN suffix
521 The default is +D.
523 PAGE_COLOR
525 Sets the color of the imaging background, i.e., the paper. Give
526 a red/green/blue triplet, with each element in the 0-255 range.
527 [255/255/255] (white).
528 PAGE_ORIENTATION
530 (* -P) Sets the orientation of the page. Choose portrait or
531 landscape [landscape].
532 PAPER_MEDIA
534 Sets the physical format of the current plot paper [A4 (or Let‐
535 ter)]. The following formats (and their widths and heights in
536 points) are recognized (Additional site-specific formats may be
537 specified in the gmt_custom_media.conf file in
538 $GMT_SHAREDIR/conf or ~/.gmt; see that file for details):
539 Media width height
541 A0 2380 3368
542 A1 1684 2380
543 A2 1190 1684
544 A3 842 1190
545 A4 595 842
546 A5 421 595
547 A6 297 421
548 A7 210 297
549 A8 148 210
550 A9 105 148
551 A10 74 105
552 B0 2836 4008
553 B1 2004 2836
554 B2 1418 2004
555 B3 1002 1418
556 B4 709 1002
557 B5 501 709
558 archA 648 864
559 archB 864 1296
560 archC 1296 1728
561 archD 1728 2592
562 archE 2592 3456
563 flsa 612 936
564 halfletter 396 612
565 statement 396 612
566 note 540 720
567 letter 612 792
568 legal 612 1008
569 11x17 792 1224
570 tabloid 792 1224
571 ledger 1224 792
572 For a completely custom format (e.g., for large format plotters)
574 you may also specify Custom_WxH, where W and H are in points
575 unless you append a unit to each dimension (c, i, m or p
576 [Default]). To force the printer to request a manual paper
577 feed, append '-' to the media name, e.g., A3- will require the
578 user to insert a A3 paper into the printer's manual feed slot.
579 To indicate you are making an EPS file, append '+' to the media
580 name. Then, GMT will attempt to issue a tight bounding box
581 [Default Bounding Box is the paper dimension].
582 PLOT_CLOCK_FORMAT
584 Formatting template that indicates how an output clock string is
585 to be plotted. This template is then used to guide the format‐
586 ting of clock strings in plot annotations. See OUT‐
587 PUT_CLOCK_FORMAT for details. [hh:mm:ss].
588 PLOT_DATE_FORMAT
590 Formatting template that indicates how an output date string is
591 to be plotted. This template is then used to guide the plotting
592 of date strings in data fields. See OUTPUT_DATE_FORMAT for
593 details. In addition, you may use a single o instead of mm (to
594 plot month name) and u instead of W[-]ww to plot "Week ##".
595 Both of these text strings will be affected by the TIME_LAN‐
596 GUAGE, TIME_FORMAT_PRIMARY and TIME_FORMAT_SECONDARY setting.
597 [yyyy-mm-dd].
598 PLOT_DEGREE_FORMAT
600 Formatting template that indicates how an output geographical
601 coordinate is to be plotted. This template is then used to
602 guide the plotting of geographical coordinates in data fields.
603 See OUTPUT_DEGREE_FORMAT for details. In addition, you can
604 append A which plots the absolute value of the coordinate. The
605 default is +ddd:mm:ss. Not all items may be plotted as this
606 depends on the annotation interval.
607 POLAR_CAP
609 Controls the appearance of gridlines near the poles for all
610 azimuthal projections and a few others in which the geographic
611 poles are plotted as points (Lambert Conic, Hammer, Mollweide,
612 Sinusoidal, and van der Grinten). Specify either none (in which
613 case there is no special handling) or pc_lat/pc_dlon. In that
614 case, normal gridlines are only drawn between the latitudes
615 -pc_lat/+pc_lat, and above those latitudes the gridlines are
616 spaced at the (presumably coarser) pc_dlon interval; the two
617 domains are separated by a small circle drawn at the pc_lat lat‐
618 itude [85/90].
619 PS_COLOR
621 Determines whether PostScript output should use RGB, HSV, or
622 CMYK when specifying color [rgb]. Note if HSV is selected it
623 does not apply to images which in that case uses RGB.
624 PS_IMAGE_COMPRESS
626 Determines if PostScript images are compressed using the Run-
627 Length Encoding scheme (rle), Lempel-Ziv-Welch compression
628 (lzw), or not at all (none) [lzw].
629 PS_IMAGE_FORMAT
631 Determines whether images created in PostScript should use ASCII
632 or binary format. The latter takes up less space and executes
633 faster but may choke some printers, especially those off serial
634 ports. Select ascii or bin [ascii].
635 PS_LINE_CAP
637 Determines how the ends of a line segment will be drawn. Choose
638 among a butt cap (default) where there is no projection beyond
639 the end of the path, a round cap where a semicircular arc with
640 diameter equal to the linewidth is drawn around the end points,
641 and square cap where a half square of size equal to the
642 linewidth extends beyond the end of the path [butt].
643 PS_LINE_JOIN
645 Determines what happens at kinks in line segments. Choose among
646 a miter join where the outer edges of the strokes for the two
647 segments are extended until they meet at an angle (as in a pic‐
648 ture frame; if the angle is too acute, a bevel join is used
649 instead, with threshold set by PS_MITER_LIMIT), round join where
650 a circular arc is used to fill in the cracks at the kinks, and
651 bevel join which is a miter join that is cut off so kinks are
652 triangular in shape [miter].
653 PS_MITER_LIMIT
655 Sets the threshold angle (integer in 0-180 range) used for
656 mitered joins. 0 and 180 are special flag values that imply the
657 PostScript default [11] and always bevels, respectively. Other
658 values sets the acute angle used to decide between mitered and
659 bevelled.
660 PS_VERBOSE
662 If TRUE we will issue comments in the PostScript file that
663 explain the logic of operations. These are useful if you need
664 to edit the file and make changes; otherwise you can set it to
665 FALSE which yields a somewhat slimmer PostScript file [FALSE].
666 TICK_LENGTH
668 The length of a tickmark. Normally, tickmarks are drawn on the
669 outside of the map boundaries. To select interior tickmarks,
670 use a negative tick_length [0.2c (or 0.075i)].
671 TICK_PEN
673 The pen thickness to be used for tickmarks in dpi units or
674 points (append p) [0.5p].
675 TIME_FORMAT_PRIMARY
677 Controls how primary month-, week-, and weekday-names are for‐
678 matted. Choose among full, abbreviated, and character. If the
679 leading f, a, or c are replaced with F, A, and C the entire
680 annotation will be in upper case.
681 TIME_FORMAT_SECONDARY
683 Controls how secondary month-, week-, and weekday-names are for‐
684 matted. Choose among full, abbreviated, and character. If the
685 leading f, a, or c are replaced with F, A, and C the entire
686 annotation will be in upper case.
687 TIME_EPOCH
689 Specifies the value of the calendar and clock at the origin
690 (zero point) of relative time units (see TIME_UNIT). It is a
691 string of the form yyyy-mm-ddT[hh:mm:ss] (Gregorian) or yyyy-
692 Www-ddT[hh:mm:ss] (ISO) Default is 2000-01-01T12:00:00, the
693 epoch of the J2000 system.
694 TIME_IS_INTERVAL
696 Used when input calendar data should be truncated and adjusted
697 to the middle of the relevant interval. In the following dis‐
698 cussion, the unit u can be one of these time units: (y year, o
699 month, u ISO week, d day, h hour, m minute, and c second).
700 TIME_IS_INTERVAL can have any of the following three values: (1)
701 OFF [Default]. No adjustment, time is decoded as given. (2)
702 +nu. Activate interval adjustment for input by truncate to pre‐
703 vious whole number of n units and then center time on the fol‐
704 lowing interval. (3) -nu. Same, but center time on the previ‐
705 ous interval. For example, with TIME_IS_INTERVAL = +1o, an
706 input data string like 1999-12 will be interpreted to mean
707 1999-12-15T12:00:00.0 (exactly middle of December), while if
708 TIME_IS_INTERVAL = OFF then that date is interpreted to mean
709 1999-12-01T00:00:00.0 (start of December) [OFF].
710 TIME_INTERVAL_FRACTION
712 Determines if partial intervals at the start and end of an axis
713 should be annotated. If the range of the partial interval
714 exceeds the specified fraction of the normal interval stride we
715 will place the annotation centered on the partial interval
716 [0.5].
717 TIME_LANGUAGE
719 Language to use when plotting calendar items such as months and
720 days. Select from:
721 BR Brazilian Portuguese
722 CN1 Simplified Chinese
723 CN2 Traditional Chinese
724 DE German
725 DK Danish
726 EH Basque
727 ES Spanish
728 FI Finnish
729 FR French
730 GR Greek
731 HU Hungarian
732 IE Irish
733 IL Hebrew
734 IS Icelandic
735 IT Italian
736 JP Japanese
737 NL Dutch
738 NO Norwegian
739 PL Polish
740 PT Portuguese
741 RU Russian
742 SE Swedish
743 SG Scottish Gaelic
744 TO Tongan
745 TR Turkish
746 UK British English
747 US US English
748 If your language is not supported, please examine the
750 $GMT_SHAREDIR/time/us.d file and make a similar file. Please
751 submit it to the GMT Developers for official inclusion. Custom
752 language files can be placed in directories $GMT_SHAREDIR/time
753 or ~/.gmt.
754 TIME_SYSTEM
756 Shorthand for a combination of TIME_EPOCH and TIME_UNIT, speci‐
757 fying which time epoch the relative time refers to and what the
758 units are. Choose from one of the preset systems below (epoch
759 and units are indicated):
760 JD -4713-11-25T12:00:00 d (Julian Date)
761 MJD 1858-11-27T00:00:00 d (Modified Julian Date)
762 J2000 2000-01-01T12:00:00 d (Astronomical time)
763 S1985 1985-01-01T00:00:00 c (Altimetric time)
764 UNIX 1970-01-01T00:00:00 c (UNIX time)
765 RD0001 0001-01-01T00:00:00 c
766 RATA 0000-12-31T00:00:00 d
767 This parameter is not stored in the .gmtdefaults4 file but is
768 translated to the respective values of TIME_EPOCH and TIME_UNIT.
769 TIME_UNIT
771 Specifies the units of relative time data since epoch (see
772 TIME_EPOCH). Choose y (year - assumes all years are 365.2425
773 days), o (month - assumes all months are of equal length y/12),
774 d (day), h (hour), m (minute), or c (second) [d].
775 TIME_WEEK_START
777 When weeks are indicated on time axes, this parameter determines
778 the first day of the week for Gregorian calendars. (The ISO
779 weekly calendar always begins weeks with Monday.) [Monday (or
780 Sunday)].
781 UNIX_TIME
783 (* -U) Specifies if a UNIX system time stamp should be plotted
784 at the lower left corner of the plot [FALSE].
785 UNIX_TIME_POS
787 (* -U) Sets the justification and the position of the UNIX time
788 stamp box relative to the current plots lower left corner of the
789 plot [BL/-2c/-2c (or BL/-0.75i/-0.75i)].
790 UNIX_TIME_FORMAT
792 Defines the format of the time information in the UNIX time
793 stamp. This format is parsed by the C function strftime, so that
794 virtually any text can be used (even not containing any time
795 information) [%Y %b %d %H:%M:%S].
796 VECTOR_SHAPE
798 Determines the shape of the head of a vector. Normally (i.e.,
799 for vector_shape = 0), the head will be triangular, but can be
800 changed to an arrow (1) or an open V (2). Intermediate settings
801 give something in between. Negative values (up to -2) are
802 allowed as well [0].
803 VERBOSE
805 (* -V) Determines if GMT programs should display run-time infor‐
806 mation or run silently [FALSE].
807 X_AXIS_LENGTH
809 Sets the default length (> 0) of the x-axis [25c (or 9i)].
810 Y_AXIS_LENGTH
812 Sets the default length (> 0) of the y-axis [15c (or 6i)].
813 X_ORIGIN
815 (* -X) Sets the x-coordinate of the origin on the paper for a
816 new plot [2.5c (or 1i)]. For an overlay, the default offset is
817 0.
818 Y_ORIGIN
820 (* -Y) Sets the y-coordinate of the origin on the paper for a
821 new plot [2.5c (or 1i)]. For an overlay, the default offset is
822 0.
823 Y2K_OFFSET_YEAR
825 When 2-digit years are used to represent 4-digit years (see var‐
826 ious DATE_FORMATs), Y2K_OFFSET_YEAR gives the first year in a
827 100-year sequence. For example, if Y2K_OFFSET_YEAR is 1729,
828 then numbers 29 through 99 correspond to 1729 through 1799,
829 while numbers 00 through 28 correspond to 1800 through 1828.
830 [1950].
831 XY_TOGGLE
833 (* -:) Set if the first two columns of input and output files
834 contain (latitude,longitude) or (y,x) rather than the expected
835 (longitude,latitude) or (x,y). FALSE means we have (x,y) both
836 on input and output. TRUE means both input and output should be
837 (y,x). IN means only input has (y,x), while OUT means only out‐
838 put should be (y,x). [FALSE].
839 Y_AXIS_TYPE
841 Determines if the annotations for a y-axis (for linear projec‐
842 tions) should be plotted horizontally (hor_text) or vertically
843 (ver_text) [hor_text].
844 SPECIFYING PENS
846 pen The attributes of lines and symbol outlines as defined by pen is
847 a comma delimetered list of width, color and texture, each of
848 which is optional. width can be indicated as a measure (points,
849 centimeters, inches) or as faint, thin[ner|nest], thick[er|est],
850 fat[ter|test], or obese. color specifies a grey shade or color
851 (see SPECIFYING COLOR below). texture is a combination of
852 dashes `-' and dots `.'.
853 SPECIFYING FILL
855 fill The attribute fill specifies the solid shade or solid color (see
856 SPECIFYING COLOR below) or the pattern used for filling poly‐
857 gons. Patterns are specified as pdpi/pattern, where pattern
858 gives the number of the built-in pattern (1-90) or the name of a
859 Sun 1-, 8-, or 24-bit raster file. The dpi sets the resolution
860 of the image. For 1-bit rasters: use Pdpi/pattern for inverse
861 video, or append :Fcolor[B[color]] to specify fore- and back‐
862 ground colors (use color = - for transparency). See GMT Cook‐
863 book & Technical Reference Appendix E for information on indi‐
864 vidual patterns.
865 SPECIFYING COLOR
867 color The color of lines, areas and patterns can be specified by a
868 valid color name; by a grey shade (in the range 0-255); by a
869 decimal color code (r/g/b, each in range 0-255; h-s-v, ranges
870 0-360, 0-1, 0-1; or c/m/y/k, each in range 0-1); or by a hexa‐
871 decimal color code (#rrggbb, as used in HTML). See the gmtcol‐
872 ors manpage for more information and a full list of color names.
873
875 To get a copy of the GMT parameter defaults in your home directory, run
876 gmtdefaults -D > ~/.gmtdefaults4
878 You may now change the settings by editing this file using a text edi‐
880 tor of your choice, or use gmtset to change specified parameters on the
881 command line.
882
884 If you have typographical errors in your .gmtdefaults4 file(s), a warn‐
885 ing message will be issued, and the GMT defaults for the affected
886 parameters will be used.
887
889 GMT(1), gmtset(1)
890GMT 4.3.1 15 May 2008 GMTDEFAULTS(1)