1PSTERNARY(1)                          GMT                         PSTERNARY(1)
2
3
4

NAME

6       psternary - Plot data on ternary diagrams
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONAL ARGUMENTS

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

UNITS

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

VECTOR ATTRIBUTES

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

EXAMPLES

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

SEE ALSO

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)
Impressum