manpagez: man pages & more
man psxyz(1)
Home | html | info | man
psxyz(1)                              GMT                             psxyz(1)




NAME

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


SYNOPSIS

       psxyz [ table ]  -Jparameters
        -Jz|Zparameters
        -Rwest/east/south/north[/zmin/zmax][+r]   [    -B[p|s]parameters  ]  [
       -Ddx/dy[/dz]  ]   [    -Gfill   ]   [    -Iintens   ]   [    -K   ]   [
       -L[+b|d|D][+xl|r|x0][+yl|r|y0][+ppen] ] [  -N ] [  -O ] [  -P ] [  -Q ]
       [   -S[symbol][size[unit]][/size_y]  ]  [   -T  ]  [   -U[stamp]  ]   [
       -V[level]  ]  [   -W[pen][attr]  ]  [   -Xx_offset  ] [  -Yy_offset ] [
       -aflags ] [ -bibinary ] [ -dinodata ] [ -eregexp ] [ -fflags ] [ -ggaps
       ] [ -hheaders ] [ -iflags ] [ -pflags ] [ -ttransp ] [ -:[i|o] ]

       Note:  No  space  is allowed between the option flag and the associated
       arguments.


DESCRIPTION

       psxyz reads (x,y,z) triplets from files [or standard input] and  gener-
       ates  PostScript  code  that  will  plot lines, polygons, or symbols at
       those locations in 3-D. If a symbol is  selected  and  no  symbol  size
       given, then psxyz will interpret the fourth column of the input data as
       symbol size. Symbols whose size is <= 0 are skipped. If no symbols  are
       specified  then  the symbol code (see -S below) must be present as last
       column in the input. If -S is not used,  a  line  connecting  the  data
       points  will  be  drawn  instead. To explicitly close polygons, use -L.
       Select a fill with -G. If -G is set, -W will control whether the  poly-
       gon  outline is drawn or not. If a symbol is selected, -G and -W deter-
       mines the fill and outline/no  outline,  respectively.  The  PostScript
       code is written to standard output.


REQUIRED ARGUMENTS

       -Jparameters (more a|)
              Select map projection.

       -Jz|Zparameters (more a|)
              Set z-axis scaling; same syntax as -Jx.

       -Rxmin/xmax/ymin/ymax[+r][+uunit] (more a|)
              Specify the region of interest.

       For perspective view p, optionally append /zmin/zmax. (more a|)


OPTIONAL ARGUMENTS

       table  One  or  more ASCII (or binary, see -bi[ncols][type]) data table
              file(s) holding a number of data columns. If no tables are given
              then we read from standard input.

       -B[p|s]parameters (more a|)
              Set map boundary frame and axes attributes.

       -Ccpt  Give  a  CPT  or  specify -Ccolor1,color2[,color3,a|] to build a
              linear continuous CPT from those colors automatically.  In  this
              case  colorn  can  be  a r/g/b triplet, a color name, or an HTML
              hexadecimal color (e.g. #aabbcc ).  If -S  is  set,  let  symbol
              fill  color  be  determined by the t-value in the fourth column.
              Additional fields are shifted over by one column (optional  size
              would  be in 5th rather than 4th field, etc.). If -S is not set,
              then psxyz expects the user to supply a multisegment file (where
              each  segment  header contains a -Zval string. The val will con-
              trol the color of the line or polygon (if -L  is  set)  via  the
              CPT.

       -Ddx/dy[/dz]
              Offset  the  plot  symbol or line locations by the given amounts
              dx/dy[dz] [Default is no offset].

       -Gfill Select color or pattern  for  filling  of  symbols  or  polygons
              [Default is no fill].  Note that psxyz will search for -G and -W
              strings in all the segment headers and let any values thus found
              over-ride the command line settings.

       -Iintens
              Use the supplied intens value (nominally in the -1 to + 1 range)
              to modulate the fill color by simulating illumination [none].

       -K (more a|)
              Do not finalize the PostScript plot.

       -L[+b|d|D][+xl|r|x0][+yl|r|y0][+ppen]
              Force closed polygons.  Alternatively, append modifiers to build
              a  polygon  from a line segment.  Append +d to build symmetrical
              envelope around y(x) using deviations dy(x) given in extra  col-
              umn  4.   Append  +D  to build asymmetrical envelope around y(x)
              using deviations dy1(x)  and  dy2(x)  from  extra  columns  4-5.
              Append  +b  to  build  asymmetrical  envelope  around y(x) using
              bounds yl(x) and yh(x) from extra columns 4-5.  Append  +xl|r|x0
              to connect first and last point to anchor points at either xmin,
              xmax, or x0, or append +yb|t|y0 to connect first and last  point
              to  anchor  points  at either ymin, ymax, or y0.  Polygon may be
              painted (-G) and optionally outlined by adding  +ppen  [no  out-
              line].   All constructed polygons are assumed to have a constant
              z value.

       -N[c|r]
              Do NOT clip symbols that fall outside map border [Default  plots
              points  whose  coordinates  are  strictly  inside the map border
              only]. The option does not apply to lines and polygons which are
              always  clipped  to the map region. For periodic (360-longitude)
              maps we must plot all symbols twice in case they are clipped  by
              the  repeating  boundary.  The -N will turn off clipping and not
              plot repeating symbols.  Use -Nr to turn off clipping but retain
              the  plotting  of  such  repeating symbols, or use -Nc to retain
              clipping but turn off plotting of repeating symbols.

       -O (more a|)
              Append to existing PostScript plot.

       -P (more a|)
              Select aPortraita plot orientation.

       -Q     Turn off the automatic sorting of items based on their  distance
              from  the viewer. The default is to sort the items so that items
              in the foreground are plotted after items in the background.

       -S[symbol][size[u]][/size_y]
              Plot symbols. If present, size is symbol size in the unit set in
              gmt.conf  (unless  c,  i,  or p is appended). If the symbol code
              (see below) is not given it will be read from the last column in
              the  input  data; this cannot be used in conjunction with binary
              input.  Optionally, append c, i, or p to indicate that the  size
              information in the input data is in units of cm, inch, or point,
              respectively [Default is PROJ_LENGTH_UNIT]. Note:  if  you  give
              both   size   and  symbol  via  the  input  file  you  must  use
              PROJ_LENGTH_UNIT to indicate the units used for the symbol  size
              or append the units to the size in the file.  Some 2-dimensional
              symbols optionally take a second size  via  size_y.   If  symbol
              sizes  are expected via the fourth data column then you may con-
              vert those values to suitable symbol sizes via the -i mechanism.

              The  uppercase  symbols A, C, D, G, H, I, N, S, T are normalized
              to have the same area as a circle with diameter size, while  the
              size of the corresponding lowercase symbols refers to the diame-
              ter of a circumscribed circle.

              You can change symbols by adding the required -S option  to  any
              of your multisegment headers.

              Choose between these symbol codes:

              -S-    x-dash  (-).  size  is  the  length of a short horizontal
                     (x-dir) line segment.

              -S+    plus (+). size is diameter of circumscribing circle.

              -Sa    star. size is diameter of circumscribing circle.

              -Sb    Vertical bar extending from base to y. size is bar width.
                     Append  u if size is in x-units [Default is plot-distance
                     units].  By default,  base  =  ymin.  Append  b[base]  to
                     change  this  value. If base is not appended then we read
                     it from the last input data column.

              -SB    Horizontal bar extending from base  to  x.  size  is  bar
                     width.   Append  u  if  size  is  in  y-units [Default is
                     plot-distance units].  By default, base  =  xmin.  Append
                     b[base]  to  change  this  value. If base is not appended
                     then we read it from the last input data column.

              -Sc    circle. size is diameter of circle.

              -Sd    diamond. size is diameter of circumscribing circle.

              -Se    ellipse. Direction  (in  degrees  counter-clockwise  from
                     horizontal),  major_axis, and minor_axis must be found in
                     columns 4, 5, and 6.

              -SE    Same as -Se, except azimuth (in degrees  east  of  north)
                     should be given instead of direction. The azimuth will be
                     mapped into an angle based on the chosen  map  projection
                     (-Se  leaves  the directions unchanged.) Furthermore, the
                     axes lengths must be given  in  geographical  instead  of
                     plot-distance  units.  An  exception  occurs for a linear
                     projection in which we assume the ellipse axes are  given
                     in  the  same units as -R.  For degenerate ellipses (cir-
                     cles) with just the diameter given, use -SE-.  The diame-
                     ter  is excepted to be given in column 4.  Alternatively,
                     append the desired diameter to -SE- and this fixed diame-
                     ter  is  used instead.  For allowable geographical units,
                     see UNITS.

              -Sf    front.            -Sfgap[/size][+l|+r][+b+c+f+s+t][+ooff-
                     set][+p[pen]].   Supply  distance gap between symbols and
                     symbol size. If gap is negative,  it  is  interpreted  to
                     mean  the  number  of symbols along the front instead. If
                     size is missing it is set to 30% of the gap, except  when
                     gap  is negative and size is thus required.  Append +l or
                     +r to plot symbols on the left or right side of the front
                     [Default is centered]. Append +type to specify which sym-
                     bol to plot:  box,  circle,  fault,  slip,  or  triangle.
                     [Default is fault]. Slip means left-lateral or right-lat-
                     eral strike-slip arrows (centered is not an option).  The
                     +s modifier optionally accepts the angle used to draw the
                     vector [30].  Append +ooffset to offset the first  symbol
                     from  the  beginning of the front by that amount [0]. The
                     chosen symbol is drawn with the same pen as set  for  the
                     line  (i.e.,  via  -W).  The use an alternate pen, append
                     +ppen.  To skip the outline, just use +p.  Note: By plac-
                     ing  -Sf options in the segment header you can change the
                     front types on a segment-by-segment basis.

              -Sg    octagon. size is diameter of circumscribing circle.

              -Sh    hexagon. size is diameter of circumscribing circle.

              -Si    inverted triangle. size  is  diameter  of  circumscribing
                     circle.

              -Sj    Rotated  rectangle.  Direction (in degrees counter-clock-
                     wise from horizontal), x-dimension, and y-dimension  must
                     be found in columns 4, 5, and 6.

              -SJ    Same  as  -Sj,  except azimuth (in degrees east of north)
                     should be given instead of direction. The azimuth will be
                     mapped  into  an angle based on the chosen map projection
                     (-Sj leaves the directions unchanged.)  Furthermore,  the
                     dimensions  must  be  given  in  geographical  instead of
                     plot-distance units.  For a degenerate rectangle (square)
                     with  one  dimension  given,  use -SJ-.  The dimension is
                     excepted to be given in column 4.  Alternatively,  append
                     the  dimension  diameter to -SJ- and this fixed dimension
                     is used instead.  An exception occurs for a  linear  pro-
                     jection  in  which  we assume the dimensions are given in
                     the same units as -R.  For allowable geographical  units,
                     see UNITS.

              -Sk    kustom symbol. Append <name>/size, and we will look for a
                     definition file called  <name>.def  in  (1)  the  current
                     directory  or  (2) in ~/.gmt or (3) in $GMT_SHAREDIR/cus-
                     tom. The symbol as defined in that file is of size 1.0 by
                     default; the appended size will scale symbol accordingly.
                     The symbols are plotted in the x-y plane.  Users may  add
                     their own custom *.def files; see CUSTOM SYMBOLS below.

              -Sl    letter  or  text  string  (less than 64 characters). Give
                     size, and append /string after the size.  Note  that  the
                     size  is  only approximate; no individual scaling is done
                     for different  characters.  Remember  to  escape  special
                     characters  like  *.  Optionally, you may append %font to
                     select a particular font [Default is FONT_ANNOT_PRIMARY].

              -Sm    math  angle  arc,  optionally with one or two arrow heads
                     [Default is no arrow heads]. The size is  the  length  of
                     the  vector  head.  Arc width is set by -W. The radius of
                     the arc and its start and  stop  directions  (in  degrees
                     counter-clockwise  from horizontal) must be given in col-
                     umns  4-6.   See   VECTOR   ATTRIBUTES   for   specifying
                     attributes.

              -SM    Same  as  -Sm  but  switches  to straight angle symbol if
                     angles subtend 90 degrees exactly.

              -Sn    pentagon. size is diameter of circumscribing circle.

              -So    column (3-D) extending from base to  z.   The  size  sets
                     base  width  (Use xsize/ysize if not the same).  Append u
                     if size is in x-units [Default is  plot-distance  units].
                     If no size is given we expect both xsize and ysize as two
                     extra data columns.  By default, base = 0.  Append  bbase
                     to  change this value.  The facet colors will be modified
                     to simulate shading.  Use -SO to disable such 3-D illumi-
                     nation.  If base is not appended then we read it from the
                     last input data column.

              -Sp    point. No size needs to be specified (1 pixel is used).

              -Sq    quoted line, i.e., lines with annotations  such  as  con-
                     tours.   It  is  assumed  that each individual line has a
                     constant z level (i.e., each line must  lie  in  the  x-y
                     plane).   Append  [d|D|f|l|L|n|x|X]info[:labelinfo].  The
                     required argument controls the placement of labels  along
                     the  quoted  lines.  Choose  among five controlling algo-
                     rithms:
                        ddist[c|i|p] or Ddist[d|e|f|k|m|M|n|s] For lower  case
                        d,  give  distances between labels on the plot in your
                        preferred measurement unit c  (cm),  i  (inch),  or  p
                        (points), while for upper case D, specify distances in
                        map units and append the unit; choose among e  (m),  f
                        (foot),  k  (km), M (mile), n (nautical mile) or u (US
                        survey foot), and d (arc degree), m (arc minute), or s
                        (arc  second).   [Default is 10c or 4i]. As an option,
                        you can append /fraction which is used  to  place  the
                        very  first label for each contour when the cumulative
                        along-contour distance equals fraction * dist  [0.25].
                        fffile.d  Reads  the  ASCII  file  ffile.d  and places
                        labels at locations in the file that matches locations
                        along  the  quoted  lines.  Inexact matches and points
                        outside the region are skipped.  l|Lline1[,*line2*,a|]
                        Give  start  and  stop  coordinates  for  one  or more
                        comma-separated straight line segments. Labels will be
                        placed  where  these lines intersect the quoted lines.
                        The format of each line specification  is  start/stop,
                        where  start  and  stop  are  either a specified point
                        lon/lat or a 2-character XY key that uses the justifi-
                        cation  format  employed in pstext to indicate a point
                        on the map, given as [LCR][BMT]. L will interpret  the
                        point  pairs  as  defining  great  circles [Default is
                        straight line].   nn_label  Specifies  the  number  of
                        equidistant  labels  for  quoted lines line [1]. Upper
                        case N starts labeling exactly at  the  start  of  the
                        line [Default centers them along the line]. N-1 places
                        one justified label at start,  while  N+1  places  one
                        justified  label  at  the end of quoted lines. Option-
                        ally, append /min_dist[c|i|p] to enforce that a  mini-
                        mum  distance  separation between successive labels is
                        enforced.   x|Xxfile.d  Reads  the  multisegment  file
                        xfile.d and places labels at the intersections between
                        the quoted lines and the lines  in  xfile.d.   X  will
                        resample  the lines first along great-circle arcs.  In
                        addition, you may optionally append +rradius[c|i|p] to
                        set  a  minimum  label separation in the x-y plane [no
                        limitation].

                        The optional labelinfo controls the specifics  of  the
                        label formatting and consists of a concatenated string
                        made up of any of the following control arguments:

                        +aangle
                               For annotations  at  a  fixed  angle,  +an  for
                               line-normal,    or    +ap   for   line-parallel
                               [Default].

                        +cdx[/dy]
                               Sets the clearance between label  and  optional
                               text box. Append c|i|p to specify the unit or %
                               to indicate a percentage of the label font size
                               [15%].

                        +d     Turns  on  debug  which will draw helper points
                               and lines to illustrate  the  workings  of  the
                               quoted line setup.

                        +e     Delay the plotting of the text. This is used to
                               build a clip path based on the text,  then  lay
                               down  other overlays while that clip path is in
                               effect, then turning of  clipping  with  psclip
                               -Cs which finally plots the original text.

                        +ffont Sets  the desired font [Default FONT_ANNOT_PRI-
                               MARY with its size changed to 9p].

                        +g[color]
                               Selects opaque text boxes [Default is transpar-
                               ent];  optionally specify the color [Default is
                               PS_PAGE_COLOR].

                        +jjust Sets  label  justification  [Default  is   MC].
                               Ignored when -SqN|n+|-1 is used.

                        +llabel
                               Sets the constant label text.

                        +Lflag Sets  the label text according to the specified
                               flag:

                               +Lh Take the label  from  the  current  segment
                               header  (first  scan  for  an  embedded -Llabel
                               option, if not use the first word following the
                               segment   flag).   For   multiple-word  labels,
                               enclose entire label  in  double  quotes.   +Ld
                               Take  the  Cartesian  plot  distances along the
                               line as the label; append  c|i|p  as  the  unit
                               [Default  is  PROJ_LENGTH_UNIT].  +LD Calculate
                               actual map distances; append d|e|f|k|n|M|n|s as
                               the  unit  [Default  is d(egrees), unless label
                               placement was based on map distances along  the
                               lines in which case we use the same unit speci-
                               fied for that algorithm]. Requires a  map  pro-
                               jection to be used.  +Lf Use text after the 2nd
                               column in the fixed label location file as  the
                               label.  Requires  the fixed label location set-
                               ting.  +Lx As +Lh but use the  headers  in  the
                               xfile.d  instead.   Requires  the crossing file
                               option.

                        +ndx[/dy]
                               Nudges the placement of labels by the specified
                               amount  (append  c|i|p  to  specify the units).
                               Increments are  considered  in  the  coordinate
                               system  defined by the orientation of the line;
                               use +N to force  increments  in  the  plot  x/y
                               coordinates  system  [no  nudging]. Not allowed
                               with +v.

                        +o     Selects rounded rectangular text  box  [Default
                               is  rectangular].   Not  applicable  for curved
                               text (+v) and only makes sense for opaque  text
                               boxes.

                        +p[pen]
                               Draws  the outline of text boxes [Default is no
                               outline]; optionally specify  pen  for  outline
                               [Default is width = 0.25p, color = black, style
                               = solid].

                        +rmin_rad
                               Will not place labels where the  lineas  radius
                               of  curvature  is less than min_rad [Default is
                               0].

                        +t[file]
                               Saves  line  label  x,  y,  and  text  to  file
                               [Line_labels.txt].  Use +T to save x, y, angle,
                               text instead.

                        +uunit Appends unit to all line labels. If unit starts
                               with a leading hyphen (-) then there will be no
                               space  between  label  value  and   the   unit.
                               [Default is no unit].

                        +v     Specifies  curved  labels  following  the  path
                               [Default is straight labels].

                        +w     Specifies how many (x,y) points will be used to
                               estimate label angles [Default is 10].

                        +=prefix
                               Prepends  prefix  to all line labels. If prefix
                               starts with a leading  hyphen  (-)  then  there
                               will  be  no  space between label value and the
                               prefix. [Default is no prefix].

                     Note: By placing -Sq options in the  segment  header  you
                     can   change   the  quoted  text  attributes  on  a  seg-
                     ment-by-segment basis.

              -Sr    rectangle. No size needs to be specified, but the x-  and
                     y-dimensions must be found in columns 4 and 5.

              -SR    Rounded rectangle. No size needs to be specified, but the
                     x- and y-dimensions and corner radius must  be  found  in
                     columns 4, 5, and 6.

              -Ss    square. size is diameter of circumscribing circle.

              -St    triangle. size is diameter of circumscribing circle.

              -Su    cube (3-D).  The size) sets length of all sides. Append u
                     if size is in x-units [Default is  plot-distance  units].
                     The  facet  colors  will be modified to simulate shading.
                     Use -SU to disable such 3-D illumination.

              -Sv    vector. Direction (in degrees counter-clockwise from hor-
                     izontal) and length must be found in columns 4 and 5, and
                     size, if not specified on  the  command-line,  should  be
                     present  in column 6.  The size is the length of the vec-
                     tor  head.  Vector  width  is  set  by  -W.   See  VECTOR
                     ATTRIBUTES for specifying attributes.

              -SV    Same  as  -Sv,  except azimuth (in degrees east of north)
                     should be given instead of direction. The azimuth will be
                     mapped  into  an angle based on the chosen map projection
                     (-Sv  leaves  the  directions  unchanged.)   See   VECTOR
                     ATTRIBUTES for specifying attributes.

              -Sw    pie   wedge.   Start  and  stop  directions  (in  degrees
                     counter-clockwise from horizontal) for pie slice must  be
                     found in columns 4 and 5.  Append +a to just draw the arc
                     line or +r to just draw the radial lines.

              -SW    Same as -Sw, except azimuths (in degrees east  of  north)
                     should  be  given  instead  of  the  two  directions. The
                     azimuths will be mapped into angles based on  the  chosen
                     map  projection  (-Sw  leaves  the directions unchanged.)
                     For geo-wedges, specify size as  a  radial  distance  and
                     append  a  length unit from d|m|s|e|f|k|M|n|u.  Append +a
                     to just draw the arc or +r to just draw the radial lines.

              -Sx    cross (x). size is diameter of circumscribing circle.

              -Sy    y-dash  (|).  size  is  the  length of a short horizontal
                     (y-dir) line segment.

              -S=    geovector. Azimuth  (in  degrees  east  from  north)  and
                     length (in km) must be found in columns 4 and 5. The size
                     is the length of the vector head. Vector width is set  by
                     -W.  See  VECTOR  ATTRIBUTES  for  specifying attributes.
                     Note: Geovector stems are drawn as thin  filled  polygons
                     and  hence  pen attributes like dashed and dotted are not
                     available.

              -S~    decorated line, i.e.,  lines  with  symbols  along  them.
                     Append   [d|D|f|l|L|n|N|s|S|x|X]info[:symbolinfo].    The
                     required argument controls the placement of symbols along
                     the  decorated  lines. Choose among six controlling algo-
                     rithms:

                        ddist[c|i|p] or Ddist[d|e|f|k|m|M|n|s]
                               For lower case d, give distances  between  sym-
                               bols  on the plot in your preferred measurement
                               unit c (cm), i (inch), or p (points), while for
                               upper  case  D,  specify distances in map units
                               and append the unit;  choose  among  e  (m),  f
                               (foot),  k (km), M (mile), n (nautical mile) or
                               u (US survey foot), and d (arc degree), m  (arc
                               minute), or s (arc second).  [Default is 10c or
                               4i]. As an option,  you  can  append  /fraction
                               which  is  used  to place the very first symbol
                               for each line when  the  cumulative  along-line
                               distance equals fraction * dist [0.25].

                        fffile.d
                               Reads the ASCII file ffile.d and places symbols
                               at locations in the file that matches locations
                               along  the decorated lines. Inexact matches and
                               points outside the region are skipped.

                        l|Lline1[,line2,a|]
                               Give the coordinates of the end points for  one
                               or more comma-separated straight line segments.
                               Symbols will be placed where these lines inter-
                               sect  the  decorated lines.  The format of each
                               line              specification              is
                               start_lon/start_lat/stop_lon/stop_lat.     Both
                               start_lon/start_lat and  stop_lon/stop_lat  can
                               be  replaced by a 2-character key that uses the
                               justification  format  employed  in  pstext  to
                               indicate  a point on the frame or center of the
                               map, given as [LCR][BMT].  L will interpret the
                               point  pairs as defining great circles [Default
                               is straight line].

                        n|Nn_symbol
                               Specifies the number of equidistant symbols for
                               decorated  lines [1]. Upper case N starts plac-
                               ing symbols exactly at the start  of  the  line
                               [Default  centers  them  along  the  line]. N-1
                               places one symbol at start,  while  N+1  places
                               one  symbol  at  the  end  of  decorated lines.
                               Optionally, append /min_dist[c|i|p] to  enforce
                               that a minimum distance separation between suc-
                               cessive symbols is enforced.

                        s|Sn_symbol
                               Same as n|Nn_symbol but implies that the  input
                               data are first to be converted into a series of
                               2-point line segments before plotting.

                        x|Xxfile.d
                               Reads the multisegment file xfile.d and  places
                               symbols  at the intersections between the deco-
                               rated lines and the lines in xfile.d.   X  will
                               resample  the  lines  first  along great-circle
                               arcs.

                        The optional symbolinfo controls the specifics of  the
                        symbol selection and formatting and consists of a con-
                        catenated string made up of any of the following  con-
                        trol arguments:

                        +aangle
                               For symbols at a fixed angle, +an for line-nor-
                               mal, or +ap for line-parallel [Default].

                        +d     Turns on debug which will  draw  helper  points
                               and  lines  to  illustrate  the workings of the
                               decorated line setup.

                        +g[fill]
                               Sets the symbol fill [no fill].

                        +ndx[/dy]
                               Nudges the placement of symbols by  the  speci-
                               fied   amount  (append  c|i|p  to  specify  the
                               units). Increments are considered in the  coor-
                               dinate system defined by the orientation of the
                               line; use +N to force increments  in  the  plot
                               x/y coordinates system [no nudging].

                        +p[pen]
                               Draws  the  outline  of  symbols [Default is no
                               outline]; optionally specify  pen  for  outline
                               [Default is width = 0.25p, color = black, style
                               = solid].

                        +w     Specifies how many (x,y) points will be used to
                               estimate symbol angles [Default is 10].

                     Note:  By  placing  -S~ options in the segment header you
                     can change the decorated lines  on  a  segment-by-segment
                     basis.

       -T     Ignore  all  input  files, including standard input. This is the
              same as specifying /dev/null (or NUL for Windows users) as input
              file.   Use  this  to  activate  only  the  options that are not
              related to plotting of lines or symbols, such as psxyz -R -J  -O
              -T to terminate a sequence of GMT plotting commands without pro-
              ducing any plotting output.

       -U[[just]/dx/dy/][c|label] (more a|)
              Draw GMT time stamp logo on plot.

       -V[level] (more a|)
              Select verbosity level [c].

       -W[pen][attr] (more a|)
              Set  pen  attributes  for  lines  or  the  outline  of   symbols
              [Defaults:  width  =  default, color = black, style = solid]. If
              the modifier +cl is appended then the  color  of  the  line  are
              taken from the CPT (see -C). If instead modifier +cf is appended
              then the color from the cpt file is applied to symbol fill.  Use
              just +c for both effects.

       -X[a|c|f|r][x-shift[u]]

       -Y[a|c|f|r][y-shift[u]] (more a|)
              Shift plot origin.

       -acol=name[^<i>a|] (more a|)
              Set aspatial column associations col=name.

       -bi[ncols][t] (more a|)
              Select  native  binary input. [Default is the required number of
              columns given the chosen settings].

       -dinodata (more a|)
              Replace input columns that equal nodata with NaN.

       -e[~]^<i>apattern^<i>a | -e[~]/regexp/[i] (more a|)
              Only accept data records that match the given pattern.

       -f[i|o]colinfo (more a|)
              Specify data types of input and/or output columns.

       -g[a]x|y|d|X|Y|D|[col]z[+|-]gap[u] (more a|)
              Determine data gaps and line breaks. The -g option is ignored if
              -S is set.

       -h[i|o][n][+c][+d][+rremark][+rtitle] (more a|)
              Skip or produce header record(s).

       -icols[+l][+sscale][+ooffset][,^<i>a|] (more a|)
              Select input columns and transformations (0 is first column).

       -p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more a|)
              Select perspective view.

       -t[transp] (more a|)
              Set PDF transparency level in percent.

       -:[i|o] (more a|)
              Swap 1st and 2nd column on input and/or output.

       -^ or just -
              Print  a  short  message  about  the syntax of the command, then
              exits (NOTE: on Windows just use -).

       -+ or just +
              Print an extensive usage (help) message, including the  explana-
              tion  of  any  module-specific  option  (but  not the GMT common
              options), then exits.

       -? or no arguments
              Print a complete usage (help) message, including the explanation
              of all options, then exits.


UNITS

       For  map distance unit, append unit d for arc degree, m for arc minute,
       and s for arc second, or e for meter [Default], f for foot, k for km, M
       for  statute  mile,  n  for nautical mile, and u for US survey foot. By
       default we compute such distances using a spherical approximation  with
       great  circles.  Prepend - to a distance (or the unit is no distance is
       given) to perform aFlat Eartha calculations (quicker but less accurate)
       or  prepend  +  to perform exact geodesic calculations (slower but more
       accurate).


VECTOR ATTRIBUTES

       Several modifiers may be appended to the  vector-producing  options  to
       specify the placement of vector heads, their shapes, and the justifica-
       tion of the vector. Below, left and right refers to  the  side  of  the
       vector  line  when  viewed from the start point to the end point of the
       segment:
          +aangle sets the angle of the vector head apex [30].

          +b places a vector head at the beginning of the vector path  [none].
          Optionally,  append  t  for  a  terminal line, c for a circle, a for
          arrow [Default], i for tail, A for plain  arrow,  and  I  for  plain
          tail.   Further  append  l|r  to only draw the left or right side of
          this head [both sides].

          +e places a vector head at  the  end  of  the  vector  path  [none].
          Optionally,  append  t  for  a  terminal line, c for a circle, a for
          arrow [Default], i for tail, A for plain  arrow,  and  I  for  plain
          tail.   Further  append  l|r  to only draw the left or right side of
          this head [both sides].

          +g-|fill turns off vector head fill (if -) or sets the  vector  head
          fill [Default fill is used, which may be no fill].

          +hshape  sets  the shape of the vector head (range -2/2). Default is
          controlled by MAP_VECTOR_SHAPE [0].

          +l draws half-arrows, using only the left side  of  specified  heads
          [both sides].

          +m  places  a  vector  head at the mid-point the vector path [none].
          Append f or r for forward or reverse direction of the  vector  [for-
          ward].  Optionally, append t for a terminal line, c for a circle, or
          a for arrow head [Default].  Further append l|r  to  only  draw  the
          left  or  right  side of this head [both sides].  Cannot be combined
          with +b or +e.

          +nnorm scales down vector attributes (pen thickness, head size) with
          decreasing  length,  where vectors shorter than norm will have their
          attributes scaled by length/norm [arrow attributes remains invariant
          to length].

          +oplon/plat  specifies  the oblique pole for the great or small cir-
          cles.  Only needed for great circles if +q is given.

          +p[-][pen] sets the vector pen attributes. If pen has  a  leading  -
          then  the  head outline is not drawn. [Default pen is used, and head
          outline is drawn]

          +q means the input angle, length data instead  represent  the  start
          and  stop  opening  angles  of the arc segment relative to the given
          point.

          +r draws half-arrows, using only the right side of  specified  heads
          [both sides].

          +t[b|e]trim  will  shift  the beginning or end point (or both) along
          the vector segment by the given trim; append suitable unit.  If  the
          modifiers  b|e are not used then trim may be two values separated by
          a slash, which is used to specify different trims for the two  ends.
          Positive  trims  will  shorted  the vector while negative trims will
          lengthen it [no trim].

       In addition, all but circular vectors may take these modifiers:
          +jjust determines how the input x,y point  relates  to  the  vector.
          Choose from beginning [default], end, or center.

          +s means the input angle, length are instead the x, y coordinates of
          the vector end point.

       Finally, Cartesian vectors may take these modifiers:
          +zscale[unit] expects input dx,dy vector  components  and  uses  the
          scale to convert to polar coordinates with length in given unit.


EXAMPLES

       To  plot  blue columns (width = 1.25 cm) at the positions listed in the
       file heights.xyz on a 3-D  projection  of  the  space  (0-10),  (0-10),
       (0-100),  with tickmarks every 2, 2, and 10, viewing it from the south-
       east at 30 degree elevation, use:

              gmt psxyz heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c -So1.25c \
                        -Gblue -Bx2+lXLABEL -By2+lYLABEL -Bz10+lZLABEL -B+t"3-D PLOT" -p135/30 \
                        -Uc -W -P > heights.ps


SEGMENT HEADER PARSING

       Segment header records  may  contain  one  of  more  of  the  following
       options:

       -Gfill Use the new fill and turn filling on

       -G-    Turn filling off

       -G     Revert to default fill (none if not set on command line)

       -Wpen  Use the new pen and turn outline on

       -W     Revert  to  default  pen  MAP_DEFAULT_PEN (if not set on command
              line)

       -W-    Turn outline off

       -Zzval Obtain fill via cpt lookup using z-value zval

       -ZNaN  Get the NaN color from the CPT


CUSTOM SYMBOLS

       psxyz allows users to define and plot their own custom symbols. This is
       done  by  encoding  the  symbol  using  our  custom  symbol  macro code
       described in Appendix N. Put all the macro codes for your new symbol in
       a  file  whose  extension must be .def; you may then address the symbol
       without giving the extension (e.g., the symbol file tsunami.def is used
       by specifying -Sktsunami/size. The definition file can contain any num-
       ber of plot code records, as well as  blank  lines  and  comment  lines
       (starting  with #). psxyz will look for the definition files in (1) the
       current  directory,   (2)   the   ~/.gmt   directory,   and   (3)   the
       $GMT_SHAREDIR/custom  directory, in that order. Freeform polygons (made
       up of straight line segments and arcs of circles)  can  be  designed  -
       these polygons can be painted and filled with a pattern. Other standard
       geometric symbols can also be used. See Appendix App-custom_symbols for
       macro definitions.


BUGS

       No  hidden  line  removal  is employed for polygons and lines. Symbols,
       however, are first sorted according to their distance  from  the  view-
       point  so  that  nearby symbols will overprint more distant ones should
       they project to the same x,y position.

       psxyz cannot handle filling of polygons that contain the south or north
       pole.  For  such  a polygon, make a copy and split it into two and make
       each explicitly contain the polar point. The two polygons will  combine
       to  give the desired effect when filled; to draw outline use the origi-
       nal polygon.


SEE ALSO

       gmt(1), gmt.conf(5), gmtcolors(5), psbasemap(1), psxy(1)


COPYRIGHT

       2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe



5.4.2                            Jun 24, 2017                         psxyz(1)

gmt5 5.4.2 - Generated Thu Jun 29 16:05:22 CDT 2017
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.