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