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