1PSXYZ(1)                     Generic Mapping Tools                    PSXYZ(1)
2
3
4

NAME

6       psxyz - Plot lines, polygons, and symbols in 3-D
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

BUGS

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

SEE ALSO

589       GMT(1), psbasemap(1), psxy(1)
590
591
592
593GMT 4.3.1                         15 May 2008                         PSXYZ(1)
Impressum