1PSXYZ(1) GMT PSXYZ(1)
2
6 psxyz - Plot lines, polygons, and symbols in 3-D
7
9 psxyz [ table ] -Jparameters
10 -Jz|Zparameters
11 -Rwest/east/south/north[/zmin/zmax][+r] [ -B[p|s]parameters ] [
12 -Ddx/dy[/dz] ] [ -Gfill ] [ -Iintens ] [ -K ] [
13 -L[+b|d|D][+xl|r|x0][+yl|r|y0][+ppen] ] [ -N ] [ -O ] [ -P ] [ -Q ]
14 [ -S[symbol][size[unit]][/size_y] ] [ -T ] [ -U[stamp] ] [
15 -V[level] ] [ -W[pen][attr] ] [ -Xx_offset ] [ -Yy_offset ] [
16 -aflags ] [ -bibinary ] [ -dinodata ] [ -eregexp ] [ -fflags ] [ -ggaps
17 ] [ -hheaders ] [ -iflags ] [ -pflags ] [ -ttransp ] [ -:[i|o] ]
18 Note: No space is allowed between the option flag and the associated
20 arguments.
21
23 psxyz reads (x,y,z) triplets from files [or standard input] and gener‐
24 ates PostScript code that will plot lines, polygons, or symbols at
25 those locations in 3-D. If a symbol is selected and no symbol size
26 given, then psxyz will interpret the fourth column of the input data as
27 symbol size. Symbols whose size is <= 0 are skipped. If no symbols are
28 specified then the symbol code (see -S below) must be present as last
29 column in the input. If -S is not used, a line connecting the data
30 points will be drawn instead. To explicitly close polygons, use -L.
31 Select a fill with -G. If -G is set, -W will control whether the poly‐
32 gon outline is drawn or not. If a symbol is selected, -G and -W deter‐
33 mines the fill and outline/no outline, respectively. The PostScript
34 code is written to standard output.
35
37 -Jparameters (more ...)
38 Select map projection.
39 -Jz|Zparameters (more ...)
41 Set z-axis scaling; same syntax as -Jx.
42 -Rxmin/xmax/ymin/ymax[+r][+uunit] (more ...)
44 Specify the region of interest.
45 For perspective view p, optionally append /zmin/zmax. (more ...)
47
49 table One or more ASCII (or binary, see -bi[ncols][type]) data table
50 file(s) holding a number of data columns. If no tables are given
51 then we read from standard input.
52 -B[p|s]parameters (more ...)
54 Set map boundary frame and axes attributes.
55 -Ccpt Give a CPT or specify -Ccolor1,color2[,color3,...] to build a
57 linear continuous CPT from those colors automatically. In this
58 case colorn can be a r/g/b triplet, a color name, or an HTML
59 hexadecimal color (e.g. #aabbcc ). If -S is set, let symbol
60 fill color be determined by the t-value in the fourth column.
61 Additional fields are shifted over by one column (optional size
62 would be in 5th rather than 4th field, etc.). If -S is not set,
63 then psxyz expects the user to supply a multisegment file (where
64 each segment header contains a -Zval string. The val will con‐
65 trol the color of the line or polygon (if -L is set) via the
66 CPT.
67 -Ddx/dy[/dz]
69 Offset the plot symbol or line locations by the given amounts
70 dx/dy[dz] [Default is no offset].
71 -Gfill Select color or pattern for filling of symbols or polygons
73 [Default is no fill]. Note that psxyz will search for -G and -W
74 strings in all the segment headers and let any values thus found
75 over-ride the command line settings.
76 -Iintens
78 Use the supplied intens value (nominally in the -1 to + 1 range)
79 to modulate the fill color by simulating illumination [none].
80 -K (more ...)
82 Do not finalize the PostScript plot.
83 -L[+b|d|D][+xl|r|x0][+yl|r|y0][+ppen]
85 Force closed polygons. Alternatively, append modifiers to build
86 a polygon from a line segment. Append +d to build symmetrical
87 envelope around y(x) using deviations dy(x) given in extra col‐
88 umn 4. Append +D to build asymmetrical envelope around y(x)
89 using deviations dy1(x) and dy2(x) from extra columns 4-5.
90 Append +b to build asymmetrical envelope around y(x) using
91 bounds yl(x) and yh(x) from extra columns 4-5. Append +xl|r|x0
92 to connect first and last point to anchor points at either xmin,
93 xmax, or x0, or append +yb|t|y0 to connect first and last point
94 to anchor points at either ymin, ymax, or y0. Polygon may be
95 painted (-G) and optionally outlined by adding +ppen [no out‐
96 line]. All constructed polygons are assumed to have a constant
97 z value.
98 -N[c|r]
100 Do NOT clip symbols that fall outside map border [Default plots
101 points whose coordinates are strictly inside the map border
102 only]. The option does not apply to lines and polygons which are
103 always clipped to the map region. For periodic (360-longitude)
104 maps we must plot all symbols twice in case they are clipped by
105 the repeating boundary. The -N will turn off clipping and not
106 plot repeating symbols. Use -Nr to turn off clipping but retain
107 the plotting of such repeating symbols, or use -Nc to retain
108 clipping but turn off plotting of repeating symbols.
109 -O (more ...)
111 Append to existing PostScript plot.
112 -P (more ...)
114 Select "Portrait" plot orientation.
115 -Q Turn off the automatic sorting of items based on their distance
117 from the viewer. The default is to sort the items so that items
118 in the foreground are plotted after items in the background.
119 -S[symbol][size[u]][/size_y]
121 Plot symbols. If present, size is symbol size in the unit set in
122 gmt.conf (unless c, i, or p is appended). If the symbol code
123 (see below) is not given it will be read from the last column in
124 the input data; this cannot be used in conjunction with binary
125 input. Optionally, append c, i, or p to indicate that the size
126 information in the input data is in units of cm, inch, or point,
127 respectively [Default is PROJ_LENGTH_UNIT]. Note: if you give
128 both size and symbol via the input file you must use
129 PROJ_LENGTH_UNIT to indicate the units used for the symbol size
130 or append the units to the size in the file. Some 2-dimensional
131 symbols optionally take a second size via size_y. If symbol
132 sizes are expected via the fourth data column then you may con‐
133 vert those values to suitable symbol sizes via the -i mechanism.
134 The uppercase symbols A, C, D, G, H, I, N, S, T are normalized
136 to have the same area as a circle with diameter size, while the
137 size of the corresponding lowercase symbols refers to the diame‐
138 ter of a circumscribed circle.
139 You can change symbols by adding the required -S option to any
141 of your multisegment headers.
142 Choose between these symbol codes:
144 -S- x-dash (-). size is the length of a short horizontal
146 (x-dir) line segment.
147 -S+ plus (+). size is diameter of circumscribing circle.
149 -Sa star. size is diameter of circumscribing circle.
151 -Sb Vertical bar extending from base to y. size is bar width.
153 Append u if size is in x-units [Default is plot-distance
154 units]. By default, base = ymin. Append b[base] to
155 change this value. If base is not appended then we read
156 it from the last input data column.
157 -SB Horizontal bar extending from base to x. size is bar
159 width. Append u if size is in y-units [Default is
160 plot-distance units]. By default, base = xmin. Append
161 b[base] to change this value. If base is not appended
162 then we read it from the last input data column.
163 -Sc circle. size is diameter of circle.
165 -Sd diamond. size is diameter of circumscribing circle.
167 -Se ellipse. Direction (in degrees counter-clockwise from
169 horizontal), major_axis, and minor_axis must be found in
170 columns 4, 5, and 6.
171 -SE Same as -Se, except azimuth (in degrees east of north)
173 should be given instead of direction. The azimuth will be
174 mapped into an angle based on the chosen map projection
175 (-Se leaves the directions unchanged.) Furthermore, the
176 axes lengths must be given in geographical instead of
177 plot-distance units. An exception occurs for a linear
178 projection in which we assume the ellipse axes are given
179 in the same units as -R. For degenerate ellipses (cir‐
180 cles) with just the diameter given, use -SE-. The diame‐
181 ter is excepted to be given in column 4. Alternatively,
182 append the desired diameter to -SE- and this fixed diame‐
183 ter is used instead. For allowable geographical units,
184 see UNITS.
185 -Sf front. -Sfgap[/size][+l|+r][+b+c+f+s+t][+ooff‐
187 set][+p[pen]]. Supply distance gap between symbols and
188 symbol size. If gap is negative, it is interpreted to
189 mean the number of symbols along the front instead. If
190 size is missing it is set to 30% of the gap, except when
191 gap is negative and size is thus required. Append +l or
192 +r to plot symbols on the left or right side of the front
193 [Default is centered]. Append +type to specify which sym‐
194 bol to plot: box, circle, fault, slip, or triangle.
195 [Default is fault]. Slip means left-lateral or right-lat‐
196 eral strike-slip arrows (centered is not an option). The
197 +s modifier optionally accepts the angle used to draw the
198 vector [30]. Append +ooffset to offset the first symbol
199 from the beginning of the front by that amount [0]. The
200 chosen symbol is drawn with the same pen as set for the
201 line (i.e., via -W). The use an alternate pen, append
202 +ppen. To skip the outline, just use +p. Note: By plac‐
203 ing -Sf options in the segment header you can change the
204 front types on a segment-by-segment basis.
205 -Sg octagon. size is diameter of circumscribing circle.
207 -Sh hexagon. size is diameter of circumscribing circle.
209 -Si inverted triangle. size is diameter of circumscribing
211 circle.
212 -Sj Rotated rectangle. Direction (in degrees counter-clock‐
214 wise from horizontal), x-dimension, and y-dimension must
215 be found in columns 4, 5, and 6.
216 -SJ Same as -Sj, except azimuth (in degrees east of north)
218 should be given instead of direction. The azimuth will be
219 mapped into an angle based on the chosen map projection
220 (-Sj leaves the directions unchanged.) Furthermore, the
221 dimensions must be given in geographical instead of
222 plot-distance units. For a degenerate rectangle (square)
223 with one dimension given, use -SJ-. The dimension is
224 excepted to be given in column 4. Alternatively, append
225 the dimension diameter to -SJ- and this fixed dimension
226 is used instead. An exception occurs for a linear pro‐
227 jection in which we assume the dimensions are given in
228 the same units as -R. For allowable geographical units,
229 see UNITS.
230 -Sk kustom symbol. Append <name>/size, and we will look for a
232 definition file called <name>.def in (1) the current
233 directory or (2) in ~/.gmt or (3) in $GMT_SHAREDIR/cus‐
234 tom. The symbol as defined in that file is of size 1.0 by
235 default; the appended size will scale symbol accordingly.
236 The symbols are plotted in the x-y plane. Users may add
237 their own custom *.def files; see CUSTOM SYMBOLS below.
238 -Sl letter or text string (less than 64 characters). Give
240 size, and append /string after the size. Note that the
241 size is only approximate; no individual scaling is done
242 for different characters. Remember to escape special
243 characters like *. Optionally, you may append %font to
244 select a particular font [Default is FONT_ANNOT_PRIMARY].
245 -Sm math angle arc, optionally with one or two arrow heads
247 [Default is no arrow heads]. The size is the length of
248 the vector head. Arc width is set by -W. The radius of
249 the arc and its start and stop directions (in degrees
250 counter-clockwise from horizontal) must be given in col‐
251 umns 4-6. See VECTOR ATTRIBUTES for specifying
252 attributes.
253 -SM Same as -Sm but switches to straight angle symbol if
255 angles subtend 90 degrees exactly.
256 -Sn pentagon. size is diameter of circumscribing circle.
258 -So column (3-D) extending from base to z. The size sets
260 base width (Use xsize/ysize if not the same). Append u
261 if size is in x-units [Default is plot-distance units].
262 If no size is given we expect both xsize and ysize as two
263 extra data columns. By default, base = 0. Append bbase
264 to change this value. The facet colors will be modified
265 to simulate shading. Use -SO to disable such 3-D illumi‐
266 nation. If base is not appended then we read it from the
267 last input data column.
268 -Sp point. No size needs to be specified (1 pixel is used).
270 -Sq quoted line, i.e., lines with annotations such as con‐
272 tours. It is assumed that each individual line has a
273 constant z level (i.e., each line must lie in the x-y
274 plane). Append [d|D|f|l|L|n|x|X]info[:labelinfo]. The
275 required argument controls the placement of labels along
276 the quoted lines. Choose among five controlling algo‐
277 rithms:
278 ddist[c|i|p] or Ddist[d|e|f|k|m|M|n|s] For lower case
279 d, give distances between labels on the plot in your
280 preferred measurement unit c (cm), i (inch), or p
281 (points), while for upper case D, specify distances in
282 map units and append the unit; choose among e (m), f
283 (foot), k (km), M (mile), n (nautical mile) or u (US
284 survey foot), and d (arc degree), m (arc minute), or s
285 (arc second). [Default is 10c or 4i]. As an option,
286 you can append /fraction which is used to place the
287 very first label for each contour when the cumulative
288 along-contour distance equals fraction * dist [0.25].
289 fffile.d Reads the ASCII file ffile.d and places
290 labels at locations in the file that matches locations
291 along the quoted lines. Inexact matches and points
292 outside the region are skipped.
293 l|Lline1[,*line2*,...] Give start and stop coordi‐
294 nates for one or more comma-separated straight line
295 segments. Labels will be placed where these lines
296 intersect the quoted lines. The format of each line
297 specification is start/stop, where start and stop are
298 either a specified point lon/lat or a 2-character XY
299 key that uses the justification format employed in
300 pstext to indicate a point on the map, given as
301 [LCR][BMT]. L will interpret the point pairs as defin‐
302 ing great circles [Default is straight line].
303 nn_label Specifies the number of equidistant labels
304 for quoted lines line [1]. Upper case N starts label‐
305 ing exactly at the start of the line [Default centers
306 them along the line]. N-1 places one justified label
307 at start, while N+1 places one justified label at the
308 end of quoted lines. Optionally, append
309 /min_dist[c|i|p] to enforce that a minimum distance
310 separation between successive labels is enforced.
311 x|Xxfile.d Reads the multisegment file xfile.d and
312 places labels at the intersections between the quoted
313 lines and the lines in xfile.d. X will resample the
314 lines first along great-circle arcs. In addition, you
315 may optionally append +rradius[c|i|p] to set a minimum
316 label separation in the x-y plane [no limitation].
317 The optional labelinfo controls the specifics of the
319 label formatting and consists of a concatenated string
320 made up of any of the following control arguments:
321 +aangle
323 For annotations at a fixed angle, +an for
324 line-normal, or +ap for line-parallel
325 [Default].
326 +cdx[/dy]
328 Sets the clearance between label and optional
329 text box. Append c|i|p to specify the unit or %
330 to indicate a percentage of the label font size
331 [15%].
332 +d Turns on debug which will draw helper points
334 and lines to illustrate the workings of the
335 quoted line setup.
336 +e Delay the plotting of the text. This is used to
338 build a clip path based on the text, then lay
339 down other overlays while that clip path is in
340 effect, then turning of clipping with psclip
341 -Cs which finally plots the original text.
342 +ffont Sets the desired font [Default FONT_ANNOT_PRI‐
344 MARY with its size changed to 9p].
345 +g[color]
347 Selects opaque text boxes [Default is transpar‐
348 ent]; optionally specify the color [Default is
349 PS_PAGE_COLOR].
350 +jjust Sets label justification [Default is MC].
352 Ignored when -SqN|n+|-1 is used.
353 +llabel
355 Sets the constant label text.
356 +Lflag Sets the label text according to the specified
358 flag:
359 +Lh Take the label from the current segment
361 header (first scan for an embedded -Llabel
362 option, if not use the first word following the
363 segment flag). For multiple-word labels,
364 enclose entire label in double quotes. +Ld
365 Take the Cartesian plot distances along the
366 line as the label; append c|i|p as the unit
367 [Default is PROJ_LENGTH_UNIT]. +LD Calculate
368 actual map distances; append d|e|f|k|n|M|n|s as
369 the unit [Default is d(egrees), unless label
370 placement was based on map distances along the
371 lines in which case we use the same unit speci‐
372 fied for that algorithm]. Requires a map pro‐
373 jection to be used. +Lf Use text after the 2nd
374 column in the fixed label location file as the
375 label. Requires the fixed label location set‐
376 ting. +Lx As +Lh but use the headers in the
377 xfile.d instead. Requires the crossing file
378 option.
379 +ndx[/dy]
381 Nudges the placement of labels by the specified
382 amount (append c|i|p to specify the units).
383 Increments are considered in the coordinate
384 system defined by the orientation of the line;
385 use +N to force increments in the plot x/y
386 coordinates system [no nudging]. Not allowed
387 with +v.
388 +o Selects rounded rectangular text box [Default
390 is rectangular]. Not applicable for curved
391 text (+v) and only makes sense for opaque text
392 boxes.
393 +p[pen]
395 Draws the outline of text boxes [Default is no
396 outline]; optionally specify pen for outline
397 [Default is width = 0.25p, color = black, style
398 = solid].
399 +rmin_rad
401 Will not place labels where the line's radius
402 of curvature is less than min_rad [Default is
403 0].
404 +t[file]
406 Saves line label x, y, and text to file
407 [Line_labels.txt]. Use +T to save x, y, angle,
408 text instead.
409 +uunit Appends unit to all line labels. If unit starts
411 with a leading hyphen (-) then there will be no
412 space between label value and the unit.
413 [Default is no unit].
414 +v Specifies curved labels following the path
416 [Default is straight labels].
417 +w Specifies how many (x,y) points will be used to
419 estimate label angles [Default is 10].
420 +=prefix
422 Prepends prefix to all line labels. If prefix
423 starts with a leading hyphen (-) then there
424 will be no space between label value and the
425 prefix. [Default is no prefix].
426 Note: By placing -Sq options in the segment header you
428 can change the quoted text attributes on a seg‐
429 ment-by-segment basis.
430 -Sr rectangle. No size needs to be specified, but the x- and
432 y-dimensions must be found in columns 4 and 5.
433 -SR Rounded rectangle. No size needs to be specified, but the
435 x- and y-dimensions and corner radius must be found in
436 columns 4, 5, and 6.
437 -Ss square. size is diameter of circumscribing circle.
439 -St triangle. size is diameter of circumscribing circle.
441 -Su cube (3-D). The size) sets length of all sides. Append u
443 if size is in x-units [Default is plot-distance units].
444 The facet colors will be modified to simulate shading.
445 Use -SU to disable such 3-D illumination.
446 -Sv vector. Direction (in degrees counter-clockwise from hor‐
448 izontal) and length must be found in columns 4 and 5, and
449 size, if not specified on the command-line, should be
450 present in column 6. The size is the length of the vec‐
451 tor head. Vector width is set by -W. See VECTOR
452 ATTRIBUTES for specifying attributes.
453 -SV Same as -Sv, except azimuth (in degrees east of north)
455 should be given instead of direction. The azimuth will be
456 mapped into an angle based on the chosen map projection
457 (-Sv leaves the directions unchanged.) See VECTOR
458 ATTRIBUTES for specifying attributes.
459 -Sw pie wedge. Start and stop directions (in degrees
461 counter-clockwise from horizontal) for pie slice must be
462 found in columns 4 and 5. Append +a to just draw the arc
463 line or +r to just draw the radial lines.
464 -SW Same as -Sw, except azimuths (in degrees east of north)
466 should be given instead of the two directions. The
467 azimuths will be mapped into angles based on the chosen
468 map projection (-Sw leaves the directions unchanged.)
469 For geo-wedges, specify size as a radial distance and
470 append a length unit from d|m|s|e|f|k|M|n|u. Append +a
471 to just draw the arc or +r to just draw the radial lines.
472 -Sx cross (x). size is diameter of circumscribing circle.
474 -Sy y-dash (|). size is the length of a short horizontal
476 (y-dir) line segment.
477 -S= geovector. Azimuth (in degrees east from north) and
479 length (in km) must be found in columns 4 and 5. The size
480 is the length of the vector head. Vector width is set by
481 -W. See VECTOR ATTRIBUTES for specifying attributes.
482 Note: Geovector stems are drawn as thin filled polygons
483 and hence pen attributes like dashed and dotted are not
484 available.
485 -S~ decorated line, i.e., lines with symbols along them.
487 Append [d|D|f|l|L|n|N|s|S|x|X]info[:symbolinfo]. The
488 required argument controls the placement of symbols along
489 the decorated lines. Choose among six controlling algo‐
490 rithms:
491 ddist[c|i|p] or Ddist[d|e|f|k|m|M|n|s]
493 For lower case d, give distances between sym‐
494 bols on the plot in your preferred measurement
495 unit c (cm), i (inch), or p (points), while for
496 upper case D, specify distances in map units
497 and append the unit; choose among e (m), f
498 (foot), k (km), M (mile), n (nautical mile) or
499 u (US survey foot), and d (arc degree), m (arc
500 minute), or s (arc second). [Default is 10c or
501 4i]. As an option, you can append /fraction
502 which is used to place the very first symbol
503 for each line when the cumulative along-line
504 distance equals fraction * dist [0.25].
505 fffile.d
507 Reads the ASCII file ffile.d and places symbols
508 at locations in the file that matches locations
509 along the decorated lines. Inexact matches and
510 points outside the region are skipped.
511 l|Lline1[,line2,...]
513 Give the coordinates of the end points for one
514 or more comma-separated straight line segments.
515 Symbols will be placed where these lines inter‐
516 sect the decorated lines. The format of each
517 line specification is
518 start_lon/start_lat/stop_lon/stop_lat. Both
519 start_lon/start_lat and stop_lon/stop_lat can
520 be replaced by a 2-character key that uses the
521 justification format employed in pstext to
522 indicate a point on the frame or center of the
523 map, given as [LCR][BMT]. L will interpret the
524 point pairs as defining great circles [Default
525 is straight line].
526 n|Nn_symbol
528 Specifies the number of equidistant symbols for
529 decorated lines [1]. Upper case N starts plac‐
530 ing symbols exactly at the start of the line
531 [Default centers them along the line]. N-1
532 places one symbol at start, while N+1 places
533 one symbol at the end of decorated lines.
534 Optionally, append /min_dist[c|i|p] to enforce
535 that a minimum distance separation between suc‐
536 cessive symbols is enforced.
537 s|Sn_symbol
539 Same as n|Nn_symbol but implies that the input
540 data are first to be converted into a series of
541 2-point line segments before plotting.
542 x|Xxfile.d
544 Reads the multisegment file xfile.d and places
545 symbols at the intersections between the deco‐
546 rated lines and the lines in xfile.d. X will
547 resample the lines first along great-circle
548 arcs.
549 The optional symbolinfo controls the specifics of the
551 symbol selection and formatting and consists of a con‐
552 catenated string made up of any of the following con‐
553 trol arguments:
554 +aangle
556 For symbols at a fixed angle, +an for line-nor‐
557 mal, or +ap for line-parallel [Default].
558 +d Turns on debug which will draw helper points
560 and lines to illustrate the workings of the
561 decorated line setup.
562 +g[fill]
564 Sets the symbol fill [no fill].
565 +ndx[/dy]
567 Nudges the placement of symbols by the speci‐
568 fied amount (append c|i|p to specify the
569 units). Increments are considered in the coor‐
570 dinate system defined by the orientation of the
571 line; use +N to force increments in the plot
572 x/y coordinates system [no nudging].
573 +p[pen]
575 Draws the outline of symbols [Default is no
576 outline]; optionally specify pen for outline
577 [Default is width = 0.25p, color = black, style
578 = solid].
579 +w Specifies how many (x,y) points will be used to
581 estimate symbol angles [Default is 10].
582 Note: By placing -S~ options in the segment header you
584 can change the decorated lines on a segment-by-segment
585 basis.
586 -T Ignore all input files, including standard input. This is the
588 same as specifying /dev/null (or NUL for Windows users) as input
589 file. Use this to activate only the options that are not
590 related to plotting of lines or symbols, such as psxyz -R -J -O
591 -T to terminate a sequence of GMT plotting commands without pro‐
592 ducing any plotting output.
593 -U[[just]/dx/dy/][c|label] (more ...)
595 Draw GMT time stamp logo on plot.
596 -V[level] (more ...)
598 Select verbosity level [c].
599 -W[pen][attr] (more ...)
601 Set pen attributes for lines or the outline of symbols
602 [Defaults: width = default, color = black, style = solid]. If
603 the modifier +cl is appended then the color of the line are
604 taken from the CPT (see -C). If instead modifier +cf is appended
605 then the color from the cpt file is applied to symbol fill. Use
606 just +c for both effects.
607 -X[a|c|f|r][x-shift[u]]
609 -Y[a|c|f|r][y-shift[u]] (more ...)
611 Shift plot origin.
612 -acol=name[...] (more ...)
614 Set aspatial column associations col=name.
615 -bi[ncols][t] (more ...)
617 Select native binary input. [Default is the required number of
618 columns given the chosen settings].
619 -dinodata (more ...)
621 Replace input columns that equal nodata with NaN.
622 -e[~]"pattern" | -e[~]/regexp/[i] (more ...)
624 Only accept data records that match the given pattern.
625 -f[i|o]colinfo (more ...)
627 Specify data types of input and/or output columns.
628 -g[a]x|y|d|X|Y|D|[col]z[+|-]gap[u] (more ...)
630 Determine data gaps and line breaks. The -g option is ignored if
631 -S is set.
632 -h[i|o][n][+c][+d][+rremark][+rtitle] (more ...)
634 Skip or produce header record(s).
635 -icols[+l][+sscale][+ooffset][,...] (more ...)
637 Select input columns and transformations (0 is first column).
638 -p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more ...)
640 Select perspective view.
641 -t[transp] (more ...)
643 Set PDF transparency level in percent.
644 -:[i|o] (more ...)
646 Swap 1st and 2nd column on input and/or output.
647 -^ or just -
649 Print a short message about the syntax of the command, then
650 exits (NOTE: on Windows just use -).
651 -+ or just +
653 Print an extensive usage (help) message, including the explana‐
654 tion of any module-specific option (but not the GMT common
655 options), then exits.
656 -? or no arguments
658 Print a complete usage (help) message, including the explanation
659 of all options, then exits.
660
662 For map distance unit, append unit d for arc degree, m for arc minute,
663 and s for arc second, or e for meter [Default], f for foot, k for km, M
664 for statute mile, n for nautical mile, and u for US survey foot. By
665 default we compute such distances using a spherical approximation with
666 great circles. Prepend - to a distance (or the unit is no distance is
667 given) to perform "Flat Earth" calculations (quicker but less accurate)
668 or prepend + to perform exact geodesic calculations (slower but more
669 accurate).
670
672 Several modifiers may be appended to the vector-producing options to
673 specify the placement of vector heads, their shapes, and the justifica‐
674 tion of the vector. Below, left and right refers to the side of the
675 vector line when viewed from the start point to the end point of the
676 segment:
677 +aangle sets the angle of the vector head apex [30].
678 +b places a vector head at the beginning of the vector path [none].
680 Optionally, append t for a terminal line, c for a circle, a for
681 arrow [Default], i for tail, A for plain arrow, and I for plain
682 tail. Further append l|r to only draw the left or right side of
683 this head [both sides].
684 +e places a vector head at the end of the vector path [none].
686 Optionally, append t for a terminal line, c for a circle, a for
687 arrow [Default], i for tail, A for plain arrow, and I for plain
688 tail. Further append l|r to only draw the left or right side of
689 this head [both sides].
690 +g-|fill turns off vector head fill (if -) or sets the vector head
692 fill [Default fill is used, which may be no fill].
693 +hshape sets the shape of the vector head (range -2/2). Default is
695 controlled by MAP_VECTOR_SHAPE [0].
696 +l draws half-arrows, using only the left side of specified heads
698 [both sides].
699 +m places a vector head at the mid-point the vector path [none].
701 Append f or r for forward or reverse direction of the vector [for‐
702 ward]. Optionally, append t for a terminal line, c for a circle, or
703 a for arrow head [Default]. Further append l|r to only draw the
704 left or right side of this head [both sides]. Cannot be combined
705 with +b or +e.
706 +nnorm scales down vector attributes (pen thickness, head size) with
708 decreasing length, where vectors shorter than norm will have their
709 attributes scaled by length/norm [arrow attributes remains invariant
710 to length].
711 +oplon/plat specifies the oblique pole for the great or small cir‐
713 cles. Only needed for great circles if +q is given.
714 +p[-][pen] sets the vector pen attributes. If pen has a leading -
716 then the head outline is not drawn. [Default pen is used, and head
717 outline is drawn]
718 +q means the input angle, length data instead represent the start
720 and stop opening angles of the arc segment relative to the given
721 point.
722 +r draws half-arrows, using only the right side of specified heads
724 [both sides].
725 +t[b|e]trim will shift the beginning or end point (or both) along
727 the vector segment by the given trim; append suitable unit. If the
728 modifiers b|e are not used then trim may be two values separated by
729 a slash, which is used to specify different trims for the two ends.
730 Positive trims will shorted the vector while negative trims will
731 lengthen it [no trim].
732 In addition, all but circular vectors may take these modifiers:
734 +jjust determines how the input x,y point relates to the vector.
735 Choose from beginning [default], end, or center.
736 +s means the input angle, length are instead the x, y coordinates of
738 the vector end point.
739 Finally, Cartesian vectors may take these modifiers:
741 +zscale[unit] expects input dx,dy vector components and uses the
742 scale to convert to polar coordinates with length in given unit.
743
745 To plot blue columns (width = 1.25 cm) at the positions listed in the
746 file heights.xyz on a 3-D projection of the space (0-10), (0-10),
747 (0-100), with tickmarks every 2, 2, and 10, viewing it from the south‐
748 east at 30 degree elevation, use:
749 gmt psxyz heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c -So1.25c \
751 -Gblue -Bx2+lXLABEL -By2+lYLABEL -Bz10+lZLABEL -B+t"3-D PLOT" -p135/30 \
752 -Uc -W -P > heights.ps
753
755 Segment header records may contain one of more of the following
756 options:
757 -Gfill Use the new fill and turn filling on
759 -G- Turn filling off
761 -G Revert to default fill (none if not set on command line)
763 -Wpen Use the new pen and turn outline on
765 -W Revert to default pen MAP_DEFAULT_PEN (if not set on command
767 line)
768 -W- Turn outline off
770 -Zzval Obtain fill via cpt lookup using z-value zval
772 -ZNaN Get the NaN color from the CPT
774
776 psxyz allows users to define and plot their own custom symbols. This is
777 done by encoding the symbol using our custom symbol macro code
778 described in Appendix N. Put all the macro codes for your new symbol in
779 a file whose extension must be .def; you may then address the symbol
780 without giving the extension (e.g., the symbol file tsunami.def is used
781 by specifying -Sktsunami/size. The definition file can contain any num‐
782 ber of plot code records, as well as blank lines and comment lines
783 (starting with #). psxyz will look for the definition files in (1) the
784 current directory, (2) the ~/.gmt directory, and (3) the
785 $GMT_SHAREDIR/custom directory, in that order. Freeform polygons (made
786 up of straight line segments and arcs of circles) can be designed -
787 these polygons can be painted and filled with a pattern. Other standard
788 geometric symbols can also be used. See Appendix App-custom_symbols for
789 macro definitions.
790
792 No hidden line removal is employed for polygons and lines. Symbols,
793 however, are first sorted according to their distance from the view‐
794 point so that nearby symbols will overprint more distant ones should
795 they project to the same x,y position.
796 psxyz cannot handle filling of polygons that contain the south or north
798 pole. For such a polygon, make a copy and split it into two and make
799 each explicitly contain the polar point. The two polygons will combine
800 to give the desired effect when filled; to draw outline use the origi‐
801 nal polygon.
802
804 gmt, gmt.conf, gmtcolors, psbasemap, psxy
805
807 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
8085.4.5 Feb 24, 2019 PSXYZ(1)