1PSTERNARY(1) GMT PSTERNARY(1)
2
3
4
6 psternary - Plot data on ternary diagrams
7
9 psternary [ table ] [ -JX *width*[unit] ] [
10 -Rwest/east/south/north[/zmin/zmax][+r] ] [ -B[p|s]parameters ] [
11 -Ccpt ] [ -Gfill ] [ -K ] [ -La/b/c ] [ -M ] [ -N ] [ -O ] [ -P
12 ] [ -S[symbol][size[u] ] [ -U[stamp] ] [ -V[level] ] [
13 -W[pen][attr] ] [ -Xx_offset ] [ -Yy_offset ] [ -aflags ] [ -bibinary
14 ] [ -dinodata ] [ -eregexp ] [ -fflags ] [ -ggaps ] [ -hheaders ] [
15 -iflags ] [ -pflags ] [ -ttransp ] [ -:[i|o] ]
16
17 Note: No space is allowed between the option flag and the associated
18 arguments.
19
21 psternary reads (a,b,c[,*z*]) records from files [or standard input]
22 and generates PostScript code that will plot symbols at those locations
23 on a ternary diagram. If a symbol is selected and no symbol size given,
24 then psternary will interpret the fourth column of the input data as
25 symbol size. Symbols whose size is <= 0 are skipped. If no symbols are
26 specified then the symbol code (see -S below) must be present as last
27 column in the input. The PostScript code is written to standard out‐
28 put.
29
31 table One or more ASCII (or binary, see -bi[ncols][type]) data table
32 file(s) holding a number of data columns. If no tables are given
33 then we read from standard input. Use -T to ignore all input
34 files, including standard input (see below).
35
36 -B[a|b|c]*args*
37 For ternary diagrams the three sides are referred to as a, b,
38 and c. Thus, to give specific settings for one of these axis
39 you must include the axis letter before the arguments. If all
40 axes have the same arguments then only give one option without
41 the axis letter. For more details, see the -B discussion in
42 psbasemap.
43
44 -Ccpt Give a CPT or specify -Ccolor1,color2[,color3,...] to build a
45 linear continuous CPT from those colors automatically. In this
46 case colorn can be a r/g/b triplet, a color name, or an HTML
47 hexadecimal color (e.g. #aabbcc ). If -S is set, let symbol
48 fill color be determined by the z-value in the fourth column.
49 Additional fields are shifted over by one column (optional size
50 would be 5th rather than 4th field, etc.).
51
52 -Gfill Select color or pattern for filling of symbols [Default is no
53 fill]. Note that psternary will search for -G and -W strings in
54 all the segment headers and let any values thus found over-ride
55 the command line settings.
56
57 -JXwidth [unit]
58 The only valid projection is linear plot with specified ternary
59 width.
60
61 -K (more ...)
62 Do not finalize the PostScript plot.
63
64 -La/b/c
65 Set the labels for the three diagram vertices [none]. These are
66 placed a distance of 3 times the MAP_LABEL_OFFSET setting from
67 their respective corners.
68
69 -M Do no plotting. Instead, convert the input (a,b,c[,*z*])
70 records to Cartesian (x,y,[,*z*]) records, where x, y are nor‐
71 malized coordinates on the triangle (i.e., 0-1 in xand
72 0-sqrt(3)/2 in y).
73
74 -N Do NOT clip symbols that fall outside map border [Default plots
75 points whose coordinates are strictly inside the map border
76 only].
77
78 -O (more ...)
79 Append to existing PostScript plot.
80
81 -P (more ...)
82 Select "Portrait" plot orientation.
83
84 -Ramin/amax/bmin/bmax/cmin/cmax
85 Give the min and max limits for each of the three axis a, b, and
86 c.
87
88 -S[symbol][size[u]]
89 Plot symbols (including vectors, pie slices, fronts, decorated
90 or quoted lines). If present, size is symbol size in the unit
91 set in gmt.conf (unless c, i, or p is appended). If the symbol
92 code (see below) is not given it will be read from the last col‐
93 umn in the input data; this cannot be used in conjunction with
94 binary input. Optionally, append c, i, or p to indicate that
95 the size information in the input data is in units of cm, inch,
96 or point, respectively [Default is PROJ_LENGTH_UNIT]. Note: if
97 you provide both size and symbol via the input file you must use
98 PROJ_LENGTH_UNIT to indicate the unit used for the symbol size
99 or append the units to the sizes in the file. If symbol sizes
100 are expected via the third data column then you may convert
101 those values to suitable symbol sizes via the -i mechanism.
102
103 The uppercase symbols A, C, D, G, H, I, N, S, T are normalized
104 to have the same area as a circle with diameter size, while the
105 size of the corresponding lowercase symbols refers to the diame‐
106 ter of a circumscribed circle.
107
108 You can change symbols by adding the required -S option to any
109 of your multisegment headers.
110
111 Choose between these symbol codes:
112
113 -S- x-dash (-). size is the length of a short horizontal
114 (x-dir) line segment.
115
116 -S+ plus (+). size is diameter of circumscribing circle.
117
118 -Sa star. size is diameter of circumscribing circle.
119
120 -Sb[size[c|i|p|u]][b[base]]
121 Vertical bar extending from base to y. size is bar width.
122 Append u if size is in x-units [Default is plot-distance
123 units]. By default, base = ymin. Append b[base] to
124 change this value. If base is not appended then we read
125 it from the last input data column.
126
127 -SB[size[c|i|p|u]][b[base]]
128 Horizontal bar extending from base to x. size is bar
129 width. Append u if size is in y-units [Default is
130 plot-distance units]. By default, base = xmin. Append
131 b[base] to change this value. If base is not appended
132 then we read it from the last input data column.
133
134 -Sc circle. size is diameter of circle.
135
136 -Sd diamond. size is diameter of circumscribing circle.
137
138 -Se ellipse. Direction (in degrees counter-clockwise from
139 horizontal), major_axis, and minor_axis must be found in
140 columns 3, 4, and 5.
141
142 -SE Same as -Se, except azimuth (in degrees east of north)
143 should be given instead of direction. The azimuth will be
144 mapped into an angle based on the chosen map projection
145 (-Se leaves the directions unchanged.) Furthermore, the
146 axes lengths must be given in geographical instead of
147 plot-distance units. An exception occurs for a linear
148 projection in which we assume the ellipse axes are given
149 in the same units as -R. For degenerate ellipses (cir‐
150 cles) with just the diameter given, use -SE-. The diame‐
151 ter is excepted to be given in column 3. Alternatively,
152 append the desired diameter to -SE- and this fixed diame‐
153 ter is used instead. For allowable geographical units,
154 see UNITS.
155
156 -Sfgap[/size][+l|+r][+b+c+f+s+t][+ooffset][+p[pen]].
157 Draw a front. Supply distance gap between symbols and
158 symbol size. If gap is negative, it is interpreted to
159 mean the number of symbols along the front instead. If
160 size is missing it is set to 30% of the gap, except when
161 gap is negative and size is thus required. Append +l or
162 +r to plot symbols on the left or right side of the front
163 [Default is centered]. Append +type to specify which sym‐
164 bol to plot: box, circle, fault, slip, or triangle.
165 [Default is fault]. Slip means left-lateral or right-lat‐
166 eral strike-slip arrows (centered is not an option). The
167 +s modifier optionally accepts the angle used to draw the
168 vector [20]. Alternatively, use +S which draws arcuate
169 arrow heads. Append +ooffset to offset the first symbol
170 from the beginning of the front by that amount [0]. The
171 chosen symbol is drawn with the same pen as set for the
172 line (i.e., via -W). The use an alternate pen, append
173 +ppen. To skip the outline, just use +p. Note: By plac‐
174 ing -Sf options in the segment header you can change the
175 front types on a segment-by-segment basis.
176
177 -Sg octagon. size is diameter of circumscribing circle.
178
179 -Sh hexagon. size is diameter of circumscribing circle.
180
181 -Si inverted triangle. size is diameter of circumscribing
182 circle.
183
184 -Sj Rotated rectangle. Direction (in degrees counter-clock‐
185 wise from horizontal), x-dimension, and y-dimension must
186 be found in columns 3, 4, and 5.
187
188 -SJ Same as -Sj, except azimuth (in degrees east of north)
189 should be given instead of direction. The azimuth will be
190 mapped into an angle based on the chosen map projection
191 (-Sj leaves the directions unchanged.) Furthermore, the
192 dimensions must be given in geographical instead of
193 plot-distance units. For a degenerate rectangle (square)
194 with one dimension given, use -SJ-. The dimension is
195 excepted to be given in column 3. Alternatively, append
196 the dimension diameter to -SJ- and this fixed dimension
197 is used instead. An exception occurs for a linear pro‐
198 jection in which we assume the dimensions are given in
199 the same units as -R. For allowable geographical units,
200 see UNITS.
201
202 -Sk kustom symbol. Append name/size, and we will look for a
203 definition file called name.def in (1) the current direc‐
204 tory or (2) in ~/.gmt or (3) in $GMT_SHAREDIR/custom. The
205 symbol as defined in that file is of size 1.0 by default;
206 the appended size will scale symbol accordingly. Users
207 may add their own custom *.def files; see CUSTOM SYMBOLS
208 below.
209
210 -Sl letter or text string (less than 256 characters). Give
211 size, and append +tstring after the size. Note that the
212 size is only approximate; no individual scaling is done
213 for different characters. Remember to escape special
214 characters like *. Optionally, you may append +ffont to
215 select a particular font [Default is FONT_ANNOT_PRIMARY]
216 and +jjustify to change justification [CM].
217
218 -Sm math angle arc, optionally with one or two arrow heads
219 [Default is no arrow heads]. The size is the length of
220 the vector head. Arc width is set by -W. The radius of
221 the arc and its start and stop directions (in degrees
222 counter-clockwise from horizontal) must be given in col‐
223 umns 3-5. See VECTOR ATTRIBUTES for specifying other
224 attributes.
225
226 -SM Same as -Sm but switches to straight angle symbol if
227 angles subtend 90 degrees exactly.
228
229 -Sn pentagon. size is diameter of circumscribing circle.
230
231 -Sp point. No size needs to be specified (1 pixel is used).
232
233 -Sq quoted line, i.e., lines with annotations such as con‐
234 tours. Append [d|D|f|l|L|n|N|s|S|x|X]info[:labelinfo].
235 The required argument controls the placement of labels
236 along the quoted lines. Choose among six controlling
237 algorithms:
238
239 ddist[c|i|p] or Ddist[d|e|f|k|m|M|n|s]
240 For lower case d, give distances between labels
241 on the plot in your preferred measurement unit
242 c (cm), i (inch), or p (points), while for
243 upper case D, specify distances in map units
244 and append the unit; choose among e (m), f
245 (foot), k (km), M (mile), n (nautical mile) or
246 u (US survey foot), and d (arc degree), m (arc
247 minute), or s (arc second). [Default is 10c or
248 4i]. As an option, you can append /fraction
249 which is used to place the very first label for
250 each contour when the cumulative along-contour
251 distance equals fraction * dist [0.25].
252
253 fffile.d
254 Reads the ASCII file ffile.d and places labels
255 at locations in the file that matches locations
256 along the quoted lines. Inexact matches and
257 points outside the region are skipped.
258
259 l|Lline1[,line2,...]
260 Give the coordinates of the end points for one
261 or more comma-separated straight line segments.
262 Labels will be placed where these lines inter‐
263 sect the quoted lines. The format of each line
264 specification is
265 start_lon/start_lat/stop_lon/stop_lat. Both
266 start_lon/start_lat and stop_lon/stop_lat can
267 be replaced by a 2-character key that uses the
268 justification format employed in pstext to
269 indicate a point on the frame or center of the
270 map, given as [LCR][BMT]. L will interpret the
271 point pairs as defining great circles [Default
272 is straight line].
273
274 n|Nn_label
275 Specifies the number of equidistant labels for
276 quoted lines [1]. Upper case N starts labeling
277 exactly at the start of the line [Default cen‐
278 ters them along the line]. N-1 places one jus‐
279 tified label at start, while N+1 places one
280 justified label at the end of quoted lines.
281 Optionally, append /min_dist[c|i|p] to enforce
282 that a minimum distance separation between suc‐
283 cessive labels is enforced.
284
285 s|Sn_label
286 Same as n|Nn_label but implies that the input
287 data are first to be converted into a series of
288 2-point line segments before plotting.
289
290 x|Xxfile.d
291 Reads the multisegment file xfile.d and places
292 labels at the intersections between the quoted
293 lines and the lines in xfile.d. X will resam‐
294 ple the lines first along great-circle arcs.
295 In addition, you may optionally append +rra‐
296 dius[c|i|p] to set a minimum label separation
297 in the x-y plane [no limitation].
298
299 The optional labelinfo controls the specifics of the
300 label formatting and consists of a concatenated string
301 made up of any of the following control arguments:
302
303 +aangle
304 For annotations at a fixed angle, +an for
305 line-normal, or +ap for line-parallel
306 [Default].
307
308 +cdx[/dy]
309 Sets the clearance between label and optional
310 text box. Append c|i|p to specify the unit or %
311 to indicate a percentage of the label font size
312 [15%].
313
314 +d Turns on debug which will draw helper points
315 and lines to illustrate the workings of the
316 quoted line setup.
317
318 +e Delay the plotting of the text. This is used to
319 build a clip path based on the text, then lay
320 down other overlays while that clip path is in
321 effect, then turning of clipping with psclip
322 -Cs which finally plots the original text.
323
324 +ffont Sets the desired font [Default FONT_ANNOT_PRI‐
325 MARY with its size changed to 9p].
326
327 +g[color]
328 Selects opaque text boxes [Default is transpar‐
329 ent]; optionally specify the color [Default is
330 PS_PAGE_COLOR].
331
332 +jjust Sets label justification [Default is MC].
333 Ignored when -SqN|n+|-1 is used.
334
335 +llabel
336 Sets the constant label text.
337
338 +Lflag Sets the label text according to the specified
339 flag:
340
341 +Lh Take the label from the current segment
342 header (first scan for an embedded -Llabel
343 option, if not use the first word following the
344 segment flag). For multiple-word labels,
345 enclose entire label in double quotes. +Ld
346 Take the Cartesian plot distances along the
347 line as the label; append c|i|p as the unit
348 [Default is PROJ_LENGTH_UNIT]. +LD Calculate
349 actual map distances; append d|e|f|k|n|M|n|s as
350 the unit [Default is d(egrees), unless label
351 placement was based on map distances along the
352 lines in which case we use the same unit speci‐
353 fied for that algorithm]. Requires a map pro‐
354 jection to be used. +Lf Use text after the 2nd
355 column in the fixed label location file as the
356 label. Requires the fixed label location set‐
357 ting. +Lx As +Lh but use the headers in the
358 xfile.d instead. Requires the crossing file
359 option.
360
361 +ndx[/dy]
362 Nudges the placement of labels by the specified
363 amount (append c|i|p to specify the units).
364 Increments are considered in the coordinate
365 system defined by the orientation of the line;
366 use +N to force increments in the plot x/y
367 coordinates system [no nudging]. Not allowed
368 with +v.
369
370 +o Selects rounded rectangular text box [Default
371 is rectangular]. Not applicable for curved
372 text (+v) and only makes sense for opaque text
373 boxes.
374
375 +p[pen]
376 Draws the outline of text boxes [Default is no
377 outline]; optionally specify pen for outline
378 [Default is width = 0.25p, color = black, style
379 = solid].
380
381 +rmin_rad
382 Will not place labels where the line's radius
383 of curvature is less than min_rad [Default is
384 0].
385
386 +t[file]
387 Saves line label x, y, and text to file
388 [Line_labels.txt]. Use +T to save x, y, angle,
389 text instead.
390
391 +uunit Appends unit to all line labels. If unit starts
392 with a leading hyphen (-) then there will be no
393 space between label value and the unit.
394 [Default is no unit].
395
396 +v Specifies curved labels following the path
397 [Default is straight labels].
398
399 +w Specifies how many (x,y) points will be used to
400 estimate label angles [Default is 10].
401
402 +x[first,last]
403 Append the suffices first and last to the cor‐
404 responding labels. This modifier is only
405 available when -SqN2 is in effect. Used to
406 annotate the start and end of a line (e.g., a
407 cross-section), append two text strings sepa‐
408 rated by comma [Default just adds a prime to
409 the second label].
410
411 +=prefix
412 Prepends prefix to all line labels. If prefix
413 starts with a leading hyphen (-) then there
414 will be no space between label value and the
415 prefix. [Default is no prefix].
416
417 Note: By placing -Sq options in the segment header you
418 can change the quoted text attributes on a seg‐
419 ment-by-segment basis.
420
421 -Sr rectangle. No size needs to be specified, but the x- and
422 y-dimensions must be found in columns 3 and 4.
423
424 -SR Rounded rectangle. No size needs to be specified, but the
425 x- and y-dimensions and corner radius must be found in
426 columns 3, 4, and 5.
427
428 -Ss square. size is diameter of circumscribing circle.
429
430 -St triangle. size is diameter of circumscribing circle.
431
432 -Sv vector. Direction (in degrees counter-clockwise from hor‐
433 izontal) and length must be found in columns 3 and 4, and
434 size, if not specified on the command-line, should be
435 present in column 5. The size is the length of the vec‐
436 tor head. Vector width is set by -W. See VECTOR
437 ATTRIBUTES for specifying other attributes.
438
439 -SV Same as -Sv, except azimuth (in degrees east of north)
440 should be given instead of direction. The azimuth will be
441 mapped into an angle based on the chosen map projection
442 (-Sv leaves the directions unchanged.) See VECTOR
443 ATTRIBUTES for specifying other attributes.
444
445 -Sw pie wedge. Start and stop directions (in degrees
446 counter-clockwise from horizontal) for pie slice must be
447 found in columns 3 and 4. Append +a to just draw the arc
448 line or +r to just draw the radial lines.
449
450 -SW Same as -Sw, except azimuths (in degrees east of north)
451 should be given instead of the two directions. The
452 azimuths will be mapped into angles based on the chosen
453 map projection (-Sw leaves the directions unchanged.)
454 For geo-wedges, specify size as a radial geographical
455 distance. For allowable geographical units, see UNITS.
456 Append +a to just draw the arc or +r to just draw the
457 radial lines.
458
459 -Sx cross (x). size is diameter of circumscribing circle.
460
461 -Sy y-dash (|). size is the length of a short vertical
462 (y-dir) line segment.
463
464 -S= geovector. Azimuth (in degrees east from north) and geo‐
465 graphical length must be found in columns 3 and 4. The
466 size is the length of the vector head. Vector width is
467 set by -W. See VECTOR ATTRIBUTES for specifying
468 attributes. Note: Geovector stems are drawn as thin
469 filled polygons and hence pen attributes like dashed and
470 dotted are not available. For allowable geographical
471 units, see UNITS.
472
473 -S~ decorated line, i.e., lines with symbols along them.
474 Append [d|D|f|l|L|n|N|s|S|x|X]info[:symbolinfo]. The
475 required argument controls the placement of symbols along
476 the decorated lines. Choose among six controlling algo‐
477 rithms:
478
479 ddist[c|i|p] or Ddist[d|e|f|k|m|M|n|s]
480 For lower case d, give distances between sym‐
481 bols on the plot in your preferred measurement
482 unit c (cm), i (inch), or p (points), while for
483 upper case D, specify distances in map units
484 and append the unit; choose among e (m), f
485 (foot), k (km), M (mile), n (nautical mile) or
486 u (US survey foot), and d (arc degree), m (arc
487 minute), or s (arc second). [Default is 10c or
488 4i]. As an option, you can append /fraction
489 which is used to place the very first symbol
490 for each line when the cumulative along-line
491 distance equals fraction * dist [0.25].
492
493 fffile.d
494 Reads the ASCII file ffile.d and places symbols
495 at locations in the file that matches locations
496 along the decorated lines. Inexact matches and
497 points outside the region are skipped.
498
499 l|Lline1[,line2,...]
500 Give the coordinates of the end points for one
501 or more comma-separated straight line segments.
502 Symbols will be placed where these lines inter‐
503 sect the decorated lines. The format of each
504 line specification is
505 start_lon/start_lat/stop_lon/stop_lat. Both
506 start_lon/start_lat and stop_lon/stop_lat can
507 be replaced by a 2-character key that uses the
508 justification format employed in pstext to
509 indicate a point on the frame or center of the
510 map, given as [LCR][BMT]. L will interpret the
511 point pairs as defining great circles [Default
512 is straight line].
513
514 n|Nn_symbol
515 Specifies the number of equidistant symbols for
516 decorated lines [1]. Upper case N starts plac‐
517 ing symbols exactly at the start of the line
518 [Default centers them along the line]. N-1
519 places one symbol at start, while N+1 places
520 one symbol at the end of decorated lines.
521 Optionally, append /min_dist[c|i|p] to enforce
522 that a minimum distance separation between suc‐
523 cessive symbols is enforced.
524
525 s|Sn_symbol
526 Same as n|Nn_symbol but implies that the input
527 data are first to be converted into a series of
528 2-point line segments before plotting.
529
530 x|Xxfile.d
531 Reads the multisegment file xfile.d and places
532 symbols at the intersections between the deco‐
533 rated lines and the lines in xfile.d. X will
534 resample the lines first along great-circle
535 arcs.
536
537 The optional symbolinfo controls the specifics of the
538 symbol selection and formatting and consists of a con‐
539 catenated string made up of any of the following con‐
540 trol arguments:
541
542 +aangle
543 For symbols at a fixed angle, +an for line-nor‐
544 mal, or +ap for line-parallel [Default].
545
546 +d Turns on debug which will draw helper points
547 and lines to illustrate the workings of the
548 decorated line setup.
549
550 +g[fill]
551 Sets the symbol fill [no fill].
552
553 +ndx[/dy]
554 Nudges the placement of symbols by the speci‐
555 fied amount (append c|i|p to specify the
556 units). Increments are considered in the coor‐
557 dinate system defined by the orientation of the
558 line; use +N to force increments in the plot
559 x/y coordinates system [no nudging].
560
561 +p[pen]
562 Draws the outline of symbols [Default is no
563 outline]; optionally specify pen for outline
564 [Default is width = 0.25p, color = black, style
565 = solid].
566
567 +s<symbol><size>
568 Specifies the code and size of the decorative
569 symbol.
570
571 +w Specifies how many (x,y) points will be used to
572 estimate symbol angles [Default is 10].
573
574 Note: By placing -S~ options in the segment header you
575 can change the decorated lines on a segment-by-segment
576 basis.
577
578 -U[[just]/dx/dy/][c|label] (more ...)
579 Draw GMT time stamp logo on plot.
580
581 -V[level] (more ...)
582 Select verbosity level [c].
583
584 -W[pen][attr] (more ...)
585 Set pen attributes for the outline of symbols.
586
587 -X[a|c|f|r][x-shift[u]]
588
589 -Y[a|c|f|r][y-shift[u]] (more ...)
590 Shift plot origin.
591
592 -bi[ncols][t] (more ...)
593 Select native binary input. [Default is the required number of
594 columns given the chosen settings].
595
596 -acol=name[...] (more ...)
597 Set aspatial column associations col=name.
598
599 -dinodata (more ...)
600 Replace input columns that equal nodata with NaN.
601
602 -e[~]"pattern" | -e[~]/regexp/[i] (more ...)
603 Only accept data records that match the given pattern.
604
605 -f[i|o]colinfo (more ...)
606 Specify data types of input and/or output columns.
607
608 -g[a]x|y|d|X|Y|D|[col]z[+|-]gap[u] (more ...)
609 Determine data gaps and line breaks. The -g option is ignored if
610 -S is set.
611
612 -h[i|o][n][+c][+d][+rremark][+rtitle] (more ...)
613 Skip or produce header record(s).
614
615 -icols[+l][+sscale][+ooffset][,...] (more ...)
616 Select input columns and transformations (0 is first column).
617
618 -:[i|o] (more ...)
619 Swap 1st and 2nd column on input and/or output.
620
621 -p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more ...)
622 Select perspective view.
623
624 -t[transp] (more ...)
625 Set PDF transparency level in percent.
626
627 -^ or just -
628 Print a short message about the syntax of the command, then
629 exits (NOTE: on Windows just use -).
630
631 -+ or just +
632 Print an extensive usage (help) message, including the explana‐
633 tion of any module-specific option (but not the GMT common
634 options), then exits.
635
636 -? or no arguments
637 Print a complete usage (help) message, including the explanation
638 of all options, then exits.
639
641 For map distance unit, append unit d for arc degree, m for arc minute,
642 and s for arc second, or e for meter [Default], f for foot, k for km, M
643 for statute mile, n for nautical mile, and u for US survey foot. By
644 default we compute such distances using a spherical approximation with
645 great circles. Prepend - to a distance (or the unit is no distance is
646 given) to perform "Flat Earth" calculations (quicker but less accurate)
647 or prepend + to perform exact geodesic calculations (slower but more
648 accurate).
649
651 Several modifiers may be appended to the vector-producing options to
652 specify the placement of vector heads, their shapes, and the justifica‐
653 tion of the vector. Below, left and right refers to the side of the
654 vector line when viewed from the start point to the end point of the
655 segment:
656 +aangle sets the angle of the vector head apex [30].
657
658 +b places a vector head at the beginning of the vector path [none].
659 Optionally, append t for a terminal line, c for a circle, a for
660 arrow [Default], i for tail, A for plain arrow, and I for plain
661 tail. Further append l|r to only draw the left or right side of
662 this head [both sides].
663
664 +e places a vector head at the end of the vector path [none].
665 Optionally, append t for a terminal line, c for a circle, a for
666 arrow [Default], i for tail, A for plain arrow, and I for plain
667 tail. Further append l|r to only draw the left or right side of
668 this head [both sides].
669
670 +g-|fill turns off vector head fill (if -) or sets the vector head
671 fill [Default fill is used, which may be no fill].
672
673 +hshape sets the shape of the vector head (range -2/2). Default is
674 controlled by MAP_VECTOR_SHAPE [0].
675
676 +l draws half-arrows, using only the left side of specified heads
677 [both sides].
678
679 +m places a vector head at the mid-point the vector path [none].
680 Append f or r for forward or reverse direction of the vector [for‐
681 ward]. Optionally, append t for a terminal line, c for a circle, or
682 a for arrow head [Default]. Further append l|r to only draw the
683 left or right side of this head [both sides]. Cannot be combined
684 with +b or +e.
685
686 +nnorm scales down vector attributes (pen thickness, head size) with
687 decreasing length, where vectors shorter than norm will have their
688 attributes scaled by length/norm [arrow attributes remains invariant
689 to length].
690
691 +oplon/plat specifies the oblique pole for the great or small cir‐
692 cles. Only needed for great circles if +q is given.
693
694 +p[-][pen] sets the vector pen attributes. If pen has a leading -
695 then the head outline is not drawn. [Default pen is used, and head
696 outline is drawn]
697
698 +q means the input angle, length data instead represent the start
699 and stop opening angles of the arc segment relative to the given
700 point.
701
702 +r draws half-arrows, using only the right side of specified heads
703 [both sides].
704
705 +t[b|e]trim will shift the beginning or end point (or both) along
706 the vector segment by the given trim; append suitable unit. If the
707 modifiers b|e are not used then trim may be two values separated by
708 a slash, which is used to specify different trims for the two ends.
709 Positive trims will shorted the vector while negative trims will
710 lengthen it [no trim].
711
712 In addition, all but circular vectors may take these modifiers:
713 +jjust determines how the input x,y point relates to the vector.
714 Choose from beginning [default], end, or center.
715
716 +s means the input angle, length are instead the x, y coordinates of
717 the vector end point.
718
719 Finally, Cartesian vectors may take these modifiers:
720 +zscale[unit] expects input dx,dy vector components and uses the
721 scale to convert to polar coordinates with length in given unit.
722
724 To plot circles (diameter = 0.1 cm) on a 6-inch-wide ternary diagram at
725 the positions listed in the file ternary.txt, with default annotations
726 and gridline spacings, using the specified labeling, tru
727
728 gmt psternary ternary.txt -R0/100/0/100/0/100 -JX6i -P -Xc -Baafg+l"Water component"+u" %" \
729 -Bbafg+l"Air component"+u" %" -Bcagf+l"Limestone component"+u" %" \
730 -B+givory+t"Example data from MATLAB Central" -Sc0.1c -Ct.cpt -Y2i -LWater/Air/Limestone > map.ps
731
733 gmt, gmt.conf, gmtcolors, psbasemap, psxy, psxyz
734
736 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
737
738
739
740
7415.4.5 Feb 24, 2019 PSTERNARY(1)