1PSXYZ(1) Generic Mapping Tools PSXYZ(1)
2
3
4
6 psxyz - Plot lines, polygons, and symbols in 3-D
7
9 psxyz files -Jparameters -Jz|Zparameters
10 -Rwest/east/south/north[/zmin/zmax][r] [ -B[p|s]parameters ] [ -Ccpt‐
11 file ] [ -Ddx/dy[dz] ] [ -Eazimuth/elevation ] [ -Gfill ] [ -H[i][nrec]
12 ] [ -K ] [ -L ] [ -M[flag] ] [ -N ] [ -O ] [ -P ] [ -Q ] [ -S[sym‐
13 bol][size] ] [ -U[just/dx/dy/][c|label] ] [ -V ] [ -W[-|+][pen] ] [
14 -X[a|c|r][x-shift[u]] ] [ -Y[a|c|r][y-shift[u]] ] [ -Zzlevel ] [
15 -:[i|o] ] [ -ccopies ] [ -bi[s|S|d|D[ncol]|c[var1/...]] ] [ -fcolinfo ]
16
18 psxyz reads (x,y,z) triplets from files [or standard input] and gener‐
19 ates PostScript code that will plot lines, polygons, or symbols at
20 those locations in 3-D. If a symbol is selected and no symbol size
21 given, then psxyz will interpret the fourth column of the input data as
22 symbol size. Symbols whose size is <= 0 are skipped. If no symbols
23 are specified then the symbol code (see -S below) must be present as
24 last column in the input. Multiple segment files may be plotted using
25 the -M option. If -S is not used, a line connecting the data points
26 will be drawn instead. To explicitly close polygons, use -L. Select a
27 fill with -G. If -G is set, -W will control whether the polygon out‐
28 line is drawn or not. If a symbol is selected, -G and -W determines
29 the fill and outline/no outline, respectively. The PostScript code is
30 written to standard output.
31
32 files List one or more file-names. If no files are given, psxyz will
33 read standard input.
34
35 -J Selects the map projection. Scale is UNIT/degree, 1:xxxxx, or
36 width in UNIT (upper case modifier). UNIT is cm, inch, or m,
37 depending on the MEASURE_UNIT setting in .gmtdefaults4, but this
38 can be overridden on the command line by appending c, i, or m to
39 the scale/width value. When central meridian is optional,
40 default is center of longitude range on -R option. Default
41 standard parallel is the equator. For map height, max dimen‐
42 sion, or min dimension, append h, +, or - to the width, respec‐
43 tively.
44 More details can be found in the psbasemap man pages.
45
46 CYLINDRICAL PROJECTIONS:
47
48 -Jclon0/lat0/scale (Cassini)
49 -Jcyl_stere/[lon0/[lat0/]]scale (Cylindrical Stereographic)
50 -Jj[lon0/]scale (Miller)
51 -Jm[lon0/[lat0/]]scale (Mercator)
52 -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral‐
53 lel)
54 -Jo[a]lon0/lat0/azimuth/scale (Oblique Mercator - point and
55 azimuth)
56 -Jo[b]lon0/lat0/lon1/lat1/scale (Oblique Mercator - two points)
57 -Joclon0/lat0/lonp/latp/scale (Oblique Mercator - point and
58 pole)
59 -Jq[lon0/[lat0/]]scale (Cylindrical Equidistant)
60 -Jtlon0/[lat0/]scale (TM - Transverse Mercator)
61 -Juzone/scale (UTM - Universal Transverse Mercator)
62 -Jy[lon0/[lat0/]]scale (Cylindrical Equal-Area)
63
64 CONIC PROJECTIONS:
65
66 -Jblon0/lat0/lat1/lat2/scale (Albers)
67 -Jdlon0/lat0/lat1/lat2/scale (Conic Equidistant)
68 -Jllon0/lat0/lat1/lat2/scale (Lambert Conic Conformal)
69
70 AZIMUTHAL PROJECTIONS:
71
72 -Jalon0/lat0[/horizon]/scale (Lambert Azimuthal Equal-Area)
73 -Jelon0/lat0[/horizon]/scale (Azimuthal Equidistant)
74 -Jflon0/lat0[/horizon]/scale (Gnomonic)
75 -Jglon0/lat0[/horizon]/scale (Orthographic)
76 -Jglon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale
77 (General Perspective).
78 -Jslon0/lat0[/horizon][/slat]/scale (General Stereographic)
79
80 MISCELLANEOUS PROJECTIONS:
81
82 -Jh[lon0/]scale (Hammer)
83 -Ji[lon0/]scale (Sinusoidal)
84 -Jkf[lon0/]scale (Eckert IV)
85 -Jk[s][lon0/]scale (Eckert IV)
86 -Jn[lon0/]scale (Robinson)
87 -Jr[lon0/]scale (Winkel Tripel)
88 -Jv[lon0/]scale (Van der Grinten)
89 -Jw[lon0/]scale (Mollweide)
90
91 NON-GEOGRAPHICAL PROJECTIONS:
92
93 -Jp[a]scale[/origin][r|z] (Polar coordinates (theta,r))
94 -Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]] (Linear, log,
95 and power scaling)
96
97 -Jz Sets the vertical scaling (for 3-D maps). Same syntax as -Jx.
98
99 -R xmin, xmax, ymin, and ymax specify the Region of interest. For
100 geographic regions, these limits correspond to west, east,
101 south, and north and you may specify them in decimal degrees or
102 in [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r if lower left
103 and upper right map coordinates are given instead of w/e/s/n.
104 The two shorthands -Rg and -Rd stand for global domain (0/360
105 and -180/+180 in longitude respectively, with -90/+90 in lati‐
106 tude). For calendar time coordinates you may either give (a)
107 relative time (relative to the selected TIME_EPOCH and in the
108 selected TIME_UNIT; append t to -JX|x), or (b) absolute time of
109 the form [date]T[clock] (append T to -JX|x). At least one of
110 date and clock must be present; the T is always required. The
111 date string must be of the form [-]yyyy[-mm[-dd]] (Gregorian
112 calendar) or yyyy[-Www[-d]] (ISO week calendar), while the clock
113 string must be of the form hh:mm:ss[.xxx]. The use of delim‐
114 iters and their type and positions must be exactly as indicated
115 (however, input, output and plot formats are customizable; see
116 gmtdefaults).
117
119 No space between the option flag and the associated arguments.
120
121 -B Sets map boundary annotation and tickmark intervals; see the
122 psbasemap man page for all the details.
123
124 -C Give a color palette file. If -S is set, let symbol fill color
125 be determined by the t-value in the fourth column. Additional
126 fields are shifted over by one column (optional size would be in
127 5th rather than 4th field, etc.). If -S is not set, then psxyz
128 expects the user to supply a multisegment line or polygon file
129 (requires -M) where each segment header contains a -Zval string.
130 The val will control the color of the line or polygon (if -L is
131 set) via the cpt file.
132
133 -D Offset the plot symbol or line locations by the given amounts
134 dx/dy[dz] [Default is no offset].
135
136 -E Sets the viewpoint's azimuth and elevation [180/90].
137
138 -G Select color or pattern for filling of symbols or polygons
139 [Default is no fill]. (See SPECIFYING FILL below).
140 Note when -M is chosen, psxyz will search for -G and -W strings
141 in all the subheaders and let any values thus found over-ride
142 the command line settings (see -M below).
143
144 -H Input file(s) has Header record(s). Number of header records
145 can be changed by editing your .gmtdefaults4 file. If used, GMT
146 default is 1 header record. Use -Hi if only input data should
147 have header records [Default will write out header records if
148 the input data have them]. Blank lines and lines starting with #
149 are always skipped.
150
151 -K More PostScript code will be appended later [Default terminates
152 the plot system].
153
154 -L Force closed polygons: connect the endpoints of the line-seg‐
155 ment(s) and draw polygons. Also, in concert with -C, -M, and -Z
156 settings in the headers will use the implied color for polygon
157 fill [Default is polygon pen color].
158
159 -M Multiple segment file. Segments are separated by a record whose
160 first character is flag [Default is '>']. On these segment
161 header records one or more of the following options can be
162 added:
163 -Gfill Use the new fill and turn filling on
164 -G- Turn filling off
165 -G+ Revert to default fill (none if not set on command line)
166 -Wpen Use the new pen and turn outline on
167 -W- Turn outline off
168 -W+ Revert to default pen (none if not set on command line)
169 -Zzval Obtain fill via cpt lookup using z-value zval
170 -ZNaN Get the NaN color from the cpt file
171
172 -N Do NOT skip symbols that fall outside map border [Default plots
173 points inside border only].
174
175 -O Selects Overlay plot mode [Default initializes a new plot sys‐
176 tem].
177
178 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
179 faults to change this].
180
181 -Q Turn off the automatic sorting of items based on their distance
182 from the viewer. The default is to sort the items so that items
183 in the foreground are plotted after items in the background.
184
185 -S Plot symbols. If present, size is symbol size in the unit set
186 in .gmtdefaults4 (unless c, i, m, or p is appended). If the
187 symbol code (see below) is not given it will be read from the
188 last column in the input data; this cannot be used in conjunc‐
189 tion with -b. Optionally, append c, i, m, p to indicate that
190 the size information in the input data is in units of cm, inch,
191 meter, or point, respectively [Default is MEASURE_UNIT]. Note:
192 if you give both size and symbol via the input file you must use
193 MEASURE_UNIT to indicate the units used for the symbol size.
194 The uppercase symbols A, C, D, G, H, I, N, S, T are normalized
195 to have the same area as a circle with diameter size, while the
196 size of the corresponding lowercase symbols refers to the diame‐
197 ter of a circumscribed circle. Choose between these symbol
198 codes:
199
200 -S- x-dash. size is the length of a short horizontal (x-dir) line
201 segment.
202
203 -Sa star. size is diameter of circumscribing circle.
204
205 -Sb Vertical bar extending from base to y. size is bar width.
206 Append u if size is in x-units [Default is plot-distance units].
207 By default, base = ymin. Append bbase to change this value.
208
209 -SB Horizontal bar extending from base to x. size is bar width.
210 Append u if size is in y-units [Default is plot-distance units].
211 By default, base = xmin. Append bbase to change this value.
212
213 -Sc circle. size is diameter of circle.
214
215 -Sd diamond. size is diameter of circumscribing circle.
216
217 -Se ellipse. Direction (in degrees counter-clockwise from horizon‐
218 tal), major_axis, and minor_axis must be found in columns 4, 5,
219 and 6.
220
221 -SE Same as -Se, except azimuth (in degrees east of north) should be
222 given instead of direction. The azimuth will be mapped into an
223 angle based on the chosen map projection (-Se leaves the direc‐
224 tions unchanged.) Furthermore, the axes lengths must be given
225 in km instead of plot-distance units. An exception occurs for a
226 linear projection in which we assume the ellipse axes are given
227 in the same units as -R.
228
229 -Sf front. -Sfgap/size[dir][type][:offset]. Supply distance gap
230 between symbols and symbol size. If gap is negative, it is
231 interpreted to mean the number of symbols along the front
232 instead. Append dir to plot symbols on the left or right side
233 of the front [Default is centered]. Append type to specify
234 which symbol to plot: box, circle, fault, slip, or triangle.
235 [Default is fault]. Slip means left-lateral or right-lateral
236 strike-slip arrows (centered is not an option). Append :offset
237 to offset the first symbol from the beginning of the front by
238 that amount [Default is 0].
239
240 -Sg octagon. size is diameter of circumscribing circle.
241
242 -Sh hexagon. size is diameter of circumscribing circle.
243
244 -Si inverted triangle. size is diameter of circumscribing circle.
245
246 -Sj Rotated rectangle. Direction (in degrees counter-clockwise from
247 horizontal), x-dimension, and y-dimension must be found in col‐
248 umns 4, 5, and 6.
249
250 -SJ Same as -Sj, except azimuth (in degrees east of north) should be
251 given instead of direction. The azimuth will be mapped into an
252 angle based on the chosen map projection (-Sj leaves the direc‐
253 tions unchanged.) Furthermore, the dimensions must be given in
254 km instead of plot-distance units. An exception occurs for a
255 linear projection in which we assume the dimensions are given in
256 the same units as -R.
257
258 -Sk kustom symbol. Append <name>/size, and we will look for a defi‐
259 nition file called <name>.def in (1) the current directory or
260 (2) in ~/.gmt or (3) in $GMT_SHAREDIR/custom. The symbol as
261 defined in that file is of size 1.0 by default; the appended
262 size will scale symbol accordingly. The symbols are plotted in
263 the x-y plane. Users may add their own custom *.def files; see
264 CUSTOM SYMBOLS in the psxy man page.
265
266 -Sl letter or text string (less than 64 characters). Give size, and
267 append /string after the size. Note that the size is only
268 approximate; no individual scaling is done for different charac‐
269 ters. Remember to escape special characters like *. Option‐
270 ally, you may append %font to select a particular font [Default
271 is ANNOT_FONT_PRIMARY].
272
273 -Sn pentagon. size is diameter of circumscribing circle.
274
275 -So column (3-D) extending from base to z. size sets base width
276 (Use xsize/ysize if not the same). Append u if size is in x-
277 units [Default is plot-distance units]. By default, base = 0.
278 Append bbase to change this value. The facet colors will be
279 modified to simulate shading. Use -SO to disable such 3-D illu‐
280 mination.
281
282 -Sp point. No size needs to be specified (1 pixel is used).
283
284 -Sq quoted line, i.e., lines with annotations such as contours. It
285 is assumed that each individual line has a constant z level
286 (i.e., each line must lie in the x-y plane). Append
287 [d|f|n|l|x]info[:labelinfo]. The required argument controls the
288 placement of labels along the quoted lines. Choose among five
289 controlling algorithms:
290
291 ddist[c|i|m|p] or Ddist[d|e|k|m|n]
292 For lower case d, give distances between labels on the
293 plot in your preferred measurement unit c (cm), i (inch),
294 m (meter), or p (points), while for upper case D, specify
295 distances in map units and append the unit; choose among
296 e (m), k (km), m (mile), n (nautical mile), or d (spheri‐
297 cal degree). [Default is 10c or 4i].
298
299 fffile.d
300 Reads the ascii file ffile.d and places labels at loca‐
301 tions in the file that matches locations along the quoted
302 lines. Inexact mathces and points outside the region are
303 skipped.
304
305 l|Lline1[,line2,...]
306 Give start and stop coordinates for one or more comma-
307 separated straight line segments. Labels will be placed
308 where these lines intersect the quoted lines. The format
309 of each line specification is start/stop, where start and
310 stop are either a specified point lon/lat or a 2-charac‐
311 ter XY key that uses the justification format employed in
312 pstext to indicate a point on the map, given as
313 [LCR][BMT]. L will interpret the point pairs as defining
314 great circles [Default is straight line].
315
316 nn_label
317 Specifies the number of equidistant labels for quoted
318 lines line [1]. Upper case N starts labeling exactly at
319 the start of the line [Default centers them along the
320 line]. N-1 places one justified label at start, while
321 N+1 places one justified label at the end of quoted
322 lines. Optionally, append /min_dist[c|i|m|p] to enforce
323 that a minimum distance separation between successive
324 labels is enforced.
325
326 x|Xxfile.d
327 Reads the multi-segment file xfile.d and places labels at
328 the intersections between the quoted lines and the lines
329 inxfile.d. X will resample the lines first along great-
330 circle arcs.
331 In addition, you may optionally append :radius[c|i|m|p] to set a mini‐
332 mum label separation in the x-y plane [no limitation].
333
334 The optional labelinfo controls the specifics of the label for‐
335 matting and consists of a concatenated string made up of any of
336 the following control arguments:
337
338 +aangle
339 For annotations at a fixed angle, +an for line-normal, or
340 +ap for line-parallel [Default].
341
342 +cdx[/dy]
343 Sets the clearance between label and optional text box.
344 Append c|i|m|p to specify the unit or % to indicate a
345 percentage of the label font size [15%].
346
347 +d Turns on debug which will draw helper points and lines to
348 illustrate the workings of the quoted line setup.
349
350 +ffont Sets the desired font [Default ANNOT_FONT_PRIMARY].
351
352 +g[color]
353 Selects opaque text boxes [Default is transparent];
354 optionally specify the color [Default is PAGE_COLOR].
355 (See SPECIFYING COLOR below).
356
357 +jjust Sets label justification [Default is MC]. Ignored when
358 -SqN|n+|-1 is used.
359
360 +kcolor
361 Sets color of text labels [Default is COLOR_BACKGROUND].
362 (See SPECIFYING COLOR below).
363
364 +llabel
365 Sets the constant label text.
366
367 +Lflag Sets the label text according to the specified flag:
368
369 +Lh Take the label from the current multisegment
370 header (first scan for an embedded -Llabel option,
371 if not use the first word following the segment
372 flag). For multiple-word labels, enclose entire
373 label in double quotes.
374
375 +Ld Take the Cartesian plot distances along the line
376 as the label; append c|i|m|p as the unit [Default
377 is MEASURE_UNIT].
378
379 +LD Calculate actual map distances; append d|e|k|m|n
380 as the unit [Default is d(egrees), unless label
381 placement was based on map distances along the
382 lines in which case we use the same unit specified
383 for that algorithm]. Requires a map projection to
384 be used.
385
386 +Lf Use text after the 2nd column in the fixed label
387 location file as the label. Requires the fixed
388 label location setting.
389
390 +Lx As +Lh but use the headers in the xfile.d instead.
391 Requires the crossing file option.
392
393 +ndx[/dy]
394 Nudges the placement of labels by the specified amount
395 (append c|i|m|p to specify the units). Increments are
396 considered in the coordinate system defined by the orien‐
397 tation of the line; use +N to force increments in the
398 plot x/y coordinates system [no nudging].
399
400 +o Selects rounded rectangular text box [Default is rectan‐
401 gular]. Not applicable for curved text (+v) and only
402 makes sense for opaque text boxes.
403
404 +p[pen]
405 Draws the outline of text boxsets [Default is no out‐
406 line]; optionally specify pen for outline [Default is
407 width = 0.25p, color = black, texture = solid]. (See
408 SPECIFYING PENS below).
409
410 +rmin_rad
411 Will not place labels where the line's radius of curva‐
412 ture is less than min_rad [Default is 0].
413
414 +ssize Sets the desired font size in points [Default is 9].
415
416 +uunit Appends unit to all line labels. If unit starts with a
417 leading hypen (-) then there will be no space between
418 label value and the unit. [Default is no unit].
419
420 +v Specifies curved labels following the path [Default is
421 straight labels].
422
423 +w Specifies how many (x, y) points will be used to estimate
424 label angles [Default is 10].
425
426 +=prefix
427 Prepends prefix to all line labels. If prefix starts
428 with a leading hypen (-) then there will be no space
429 between label value and the prefix. [Default is no pre‐
430 fix].
431
432 -Sr rectangle. No size needs to be specified, but the x- and y-
433 dimensions must be found in columns 4 and 5.
434
435 -Ss square. size is diameter of circumscribing circle.
436
437 -St triangle. size is diameter of circumscribing circle.
438
439 -Su cube (3-D). size sets length of all sides. Append u if size is
440 in x-units [Default is plot-distance units]. The facet colors
441 will be modified to simulate shading. Use -SU to disable such
442 3-D illumination.
443
444 -Sv vector. Direction and length must be found in columns 4 and 5.
445 size, if present, will be interpreted as
446 arrowwidth/headlength/headwidth [Default unit is
447 0.075c/0.3c/0.25c (or 0.03i/0.12i/0.1i)]. By default arrow
448 attributes remains invariant to the length of the arrow. To
449 have the size of the vector scale down with decreasing size,
450 append nnorm, where vectors shorter than norm will have their
451 attributes scaled by length/norm. To center vector on balance
452 point, use -Svb; to align point with the vector head, use -Svh;
453 to align point with the vector tail, use -Svt [Default]. To
454 give the head point's x, y, z coordinates instead of direction
455 and length, use -Svs. Upper case B, H, T, S will draw a double-
456 headed vector [Default is single head].
457
458 -SV Same as -Sv, except azimuth should be given instead of direc‐
459 tion. The azimuth will be mapped into an angle based on the
460 chosen map projection (-Sv leaves the directions unchanged.)
461
462 -Sw pie wedge. Start and stop directions (in degrees counter-clock‐
463 wise from horizontal) for pie slice must be found in columns 4
464 and 5.
465
466 -SW Same as -Sw, except azimuths (in degrees east of north) should
467 be given instead of the two directions. The azimuths will be
468 mapped into angles based on the chosen map projection (-Sw
469 leaves the directions unchanged.)
470
471 -Sx cross. size is diameter of circumscribing circle.
472
473 -Sy y-dash. size is the length of a short horizontal (y-dir) line
474 segment.
475
476 -Sz zdash. size is the length of a short vertical (z-dir) line seg‐
477 ment.
478
479 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
480 user may specify the justification of the stamp and where the
481 stamp should fall on the page relative to lower left corner of
482 the plot. For example, BL/0/0 will align the lower left corner
483 of the time stamp with the lower left corner of the plot.
484 Optionally, append a label, or c (which will plot the command
485 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
486 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
487 man page for details. The time string will be in the locale set
488 by the environment variable TZ (generally local time).
489
490 -V Selects verbose mode, which will send progress reports to stderr
491 [Default runs "silently"].
492
493 -W Set pen attributes for lines or the outline of symbols
494 [Defaults: width = 1, color = black, texture = solid]. A lead‐
495 ing + will use the lookup color (via -C) for both symbol fill
496 and outline pen color, while a leading - will set outline pen
497 color and turn off symbol fill. (See SPECIFYING PENS below).
498
499 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
500 shift) and optionally append the length unit (c, i, m, p). You
501 can prepend a to shift the origin back to the original position
502 after plotting, or prepend r [Default] to reset the current
503 origin to the new location. If -O is used then the default (x-
504 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
505 r2.5c). Alternatively, give c to align the center coordinate (x
506 or y) of the plot with the center of the page based on current
507 page size.
508
509 -Z For 3-D projections: Sets the z-level of the basemap [0].
510
511 -: Toggles between (longitude,latitude) and (latitude,longitude)
512 input and/or output. [Default is (longitude,latitude)]. Append
513 i to select input only or o to select output only. [Default
514 affects both].
515
516 -bi Selects binary input. Append s for single precision [Default is
517 d (double)]. Uppercase S or D will force byte-swapping.
518 Optionally, append ncol, the number of columns in your binary
519 input file if it exceeds the columns needed by the program. Or
520 append c if the input file is netCDF. Optionally, append
521 var1/var2/... to specify the variables to be read. [Default is
522 the required number of columns given the chosen settings].
523
524 -c Specifies the number of plot copies. [Default is 1].
525
526 -f Special formatting of input and/or output columns (time or geo‐
527 graphical data). Specify i or o to make this apply only to
528 input or output [Default applies to both]. Give one or more
529 columns (or column ranges) separated by commas. Append T (abso‐
530 lute calendar time), t (relative time in chosen TIME_UNIT since
531 TIME_EPOCH), x (longitude), y (latitude), or f (floating point)
532 to each column or column range item. Shorthand -f[i|o]g means
533 -f[i|o]0x,1y (geographic coordinates).
534
535 SPECIFYING PENS
536 pen The attributes of lines and symbol outlines as defined by pen is
537 a comma delimetered list of width, color and texture, each of
538 which is optional. width can be indicated as a measure (points,
539 centimeters, inches) or as faint, thin[ner|nest], thick[er|est],
540 fat[ter|test], or obese. color specifies a grey shade or color
541 (see SPECIFYING COLOR below). texture is a combination of
542 dashes `-' and dots `.'.
543
544 SPECIFYING FILL
545 fill The attribute fill specifies the solid shade or solid color (see
546 SPECIFYING COLOR below) or the pattern used for filling poly‐
547 gons. Patterns are specified as pdpi/pattern, where pattern
548 gives the number of the built-in pattern (1-90) or the name of a
549 Sun 1-, 8-, or 24-bit raster file. The dpi sets the resolution
550 of the image. For 1-bit rasters: use Pdpi/pattern for inverse
551 video, or append :Fcolor[B[color]] to specify fore- and back‐
552 ground colors (use color = - for transparency). See GMT Cook‐
553 book & Technical Reference Appendix E for information on indi‐
554 vidual patterns.
555
556 SPECIFYING COLOR
557 color The color of lines, areas and patterns can be specified by a
558 valid color name; by a grey shade (in the range 0-255); by a
559 decimal color code (r/g/b, each in range 0-255; h-s-v, ranges
560 0-360, 0-1, 0-1; or c/m/y/k, each in range 0-1); or by a hexa‐
561 decimal color code (#rrggbb, as used in HTML). See the gmtcol‐
562 ors manpage for more information and a full list of color names.
563
565 To plot blue columns (width = 1.25 cm) at the positions listed in the
566 file heights.xyz on a 3-D projection of the space (0-10), (0-10),
567 (0-100), with tickmarks every 2, 2, and 10, viewing it from the south‐
568 east at 30 degree elevation, use:
569
570 psxyz heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c -So1.25c -Gblue
571 -B2:XLABEL:/2:YLABEL:/10:ZLABEL::."3-D PLOT":15 -E135/30 -Uc -W -P >
572 heights.ps
573
575 No hidden line removal is employed for polygons and lines. Symbols,
576 however, are first sorted according to their distance from the view‐
577 point so that nearby symbols will overprint more distant ones should
578 they project to the same x,y position.
579 psxyz cannot handle filling of polygons that contain the south or north
580 pole. For such a polygon, make a copy and split it into two and make
581 each explicitly contain the polar point. The two polygons will combine
582 to give the desired effect when filled; to draw outline use the origi‐
583 nal polygon.
584 The -N option does not adjust the BoundingBox information so you may
585 have to post-process the PostScript output with ps2raster -A to obtain
586 the correct BoundingBox.
587
589 GMT(1), psbasemap(1), psxy(1)
590
591
592
593GMT 4.3.1 15 May 2008 PSXYZ(1)