NAME
psxyz - Plot lines, polygons, and symbols in 3-D
SYNOPSIS
psxyz files -Jparameters
-Rwest/east/south/north/zmin/zmax[r] [ -Btickinfo ] [
-Ccptfile ] [ -Eazimuth/elevation ] [ -Gfill ] [ -H[nrec] ]
[ -K ] [ -L ] [ -M[flag] ] [ -N ] [ -O ] [ -P ] [
-S[symbol][size] ] [ -U[/dx/dy/][label] ] [ -V ] [ -W[pen] ]
[ -Xx-shift ] [ -Yy-shift ] [ -Zzlevel ] [ -: ] [ -ccopies ]
[ -bi[s][n] ]
DESCRIPTION
psxyz reads (x,y,z) triplets from files [or standard input]
and generates 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 inter-
pret the fourth column of the input data as symbol size. If
no symbols are specified then the symbol code (see -S below)
must be present as last column in the input. Multiple seg-
ment files may be plotted using the -M option. If no sym-
bols are selected, a line will be drawn. To explicitly
close polygons, use -L. Select a shade with -G. If -G is
set, -W will control whether the polygon outline is drawn or
not. If a symbol is selected, -G and -W determines the fill
color and outline/no outline, respectively. The PostScript
code is written to standard output.
files
List one or more file-names. If no files are given,
psxyz will read standard input.
-J Selects the map projection. Scale is UNIT/degree,
1:xxxxx, or width in UNIT (upper case modifier). UNIT
is cm, inch, or m, depending on the MEASURE_UNIT set-
ting in .gmtdefaults, but this can be overridden on the
command line by appending the c, i, or m to the
scale/width value.
CYLINDRICAL PROJECTIONS:
-Jclon0/lat0/scale (Cassini)
-Jjlon0/scale (Miller)
-Jmscale (Mercator - Greenwich and Equator as origin)
-Jmlon0/lat0/scale (Mercator - Give meridian and stan-
dard parallel)
-Joalon0/lat0/azimuth/scale (Oblique Mercator - point
and azimuth)
-Joblon0/lat0/lon1/lat1/scale (Oblique Mercator - two
points)
-Joclon0/lat0/lonp/latp/scale (Oblique Mercator - point
and pole)
-Jqlon0/scale (Equidistant Cylindrical Projection
(Plate Carree))
-Jtlon0/scale (TM - Transverse Mercator, with Equator
as y = 0)
-Jtlon0/lat0/scale (TM - Transverse Mercator, set ori-
gin)
-Juzone/scale (UTM - Universal Transverse Mercator)
-Jylon0/lats/scale (Basic Cylindrical Projection)
AZIMUTHAL PROJECTIONS:
-Jalon0/lat0/scale (Lambert).
-Jelon0/lat0/scale (Equidistant).
-Jflon0/lat0/horizon/scale (Gnomonic).
-Jglon0/lat0/scale (Orthographic).
-Jslon0/lat0/scale (General Stereographic)
CONIC PROJECTIONS:
-Jblon0/lat0/lat1/lat2/scale (Albers)
-Jdlon0/lat0/lat1/lat2/scale (Equidistant)
-Jllon0/lat0/lat1/lat2/scale (Lambert)
MISCELLANEOUS PROJECTIONS:
-Jhlon0/scale (Hammer)
-Jilon0/scale (Sinusoidal)
-Jk[f|s]lon0/scale (Eckert IV (f) and VI (s))
-Jnlon0/scale (Robinson)
-Jrlon0/scale (Winkel Tripel)
-Jvlon0/scale (Van der Grinten)
-Jwlon0/scale (Mollweide)
NON-GEOGRAPHICAL PROJECTIONS:
-Jpscale[/origin] (polar (theta,r) coordinates, option-
ally offset theta [0])
-Jxx-scale[l|ppow][/y-scale[l|ppow]] (Linear, log, and
power scaling)
More details can be found in the psbasemap manpages.
-Jz Sets the vertical scaling (for 3-D maps). Same syntax
as -Jx.
-R west, east, south, and north specify the Region of
interest. To specify boundaries in degrees and minutes
[and seconds], use the dd:mm[:ss] format. Append r if
lower left and upper right map coordinates are given
instead of wesn.
OPTIONS
No space between the option flag and the associated
arguments.
-B Sets map boundary tickmark intervals. See psbasemap for
details.
-C Give a color palette file. If -S is set, let symbol
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 a
multisegment polygon file (requires -M) where each seg-
ment header contains a -Zval string. The val controls
the polygon color via the cpt file.
-E Sets the viewpoint's azimuth and elevation [180/90].
-G Select filling of polygons and symbols. Append the
shade (0-255), color (r/g/b), or P|pdpi/pattern
(polygons only) [Default is no fill]. Note when -M is
chosen, psxyz will search for -G and -W strings in all
the subheaders and let any found values over-ride the
command line settings.
-H Input file(s) has Header record(s). Number of header
records can be changed by editing your .gmtdefaults
file. If used, GMT default is 1 header record.
-K More PostScript code will be appended later [Default
terminates the plot system].
-L Force closed polygons: will connect the endpoints of
the line-sement(s) and draw polygons.
-M Multiple segment file. Segments are separated by a
record whose first character is flag. [Default is
'>'].
-N Do NOT skip symbols that fall outside map border
[Default plots points inside border only].
-O Selects Overlay plot mode [Default initializes a new
plot system].
-P Selects Portrait plotting mode [GMT Default is
Landscape, see gmtdefaults to change this].
-S Plot symbols. size is symbol size in the unit set in
.gmtdefaults (unless c, i, m, or p is appended). The
uppercase symbols A, C, D, H, I, S, T are normalized to
have the same area as a circle of given size, while the
corresponding lowercase symbols are circumscribed by
the circle. Choose between:
-Sa star. size is diameter of circumscribing circle.
-Sb (b)ar 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 = 0. Append bbase to
change this value.
-Sc (c)ircle. size is diameter of circle.
-Sd (d)iamond. size is diameter of circumscribing circle.
-Se ellipse. Direction (in degrees counterclockwise 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 projec-
tion (-Se leaves the directions unchanged.) Further-
more, the axes lengths must be given in km instead of
plot-distance units.
-Sf fault. Give distance gap between ticks and ticklength.
If gap is negative, it is interpreted to mean number of
ticks instead. Append l or r to draw tick on the left
or right side of line [Default is centered]. Upper
case L or R draws a triangle instead of line segment.
-Sh hexagon. size is diameter of circumscribing circle.
-Si inverted triangle. size is diameter of circumscribing
circle.
-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 ANOT_FONT].
-So c(o)lumn (3-D) extending from base to z. size sets
base width (Use xsize/ysize if not the same). Append u
if size is in x-units [Default is plot-distance units].
By default, base = 0. Append bbase to change this
value.
-Sp (p)oint. No size needs to be specified.
-Ss (s)quare. size is diameter of circumscribing circle.
-St (t)riangle. size is diameter of circumscribing circle.
-Su c(u)be (3-D). size sets length of all sides. Append u
if size is in x-units [Default is plot-distance units].
-Sv (v)ector. Direction and length must be found in
columns 4 and 5. size means
arrowwidth/headlength/headwidth in [[Default is
0.075c/0.3c/0.25c (or 0.03i/0.12i/0.1i)]. By default
arrow attributes remains invariant to the length of the
arrow. To have the size of the vector scale down with
decreasing size, append nnorm, where vectors shorter
than norm will have their attributes scaled by
length/norm.
-SV Same as -Sv, except azimuth 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.)
-Sx (x)cross. size is diameter of circumscribing circle.
-U Draw Unix System time stamp on plot. User may specify
where the lower left corner of the stamp should fall on
the page relative to lower left corner of plot.
Optionally, append a label, or c (which will plot the
command string.)
-V Selects verbose mode, which will send progress reports
to stderr [Default runs "silently"].
-W Set pen attributes. [Defaults: width = 1, color =
0/0/0, texture = solid]. Implicitly draws the outline
of symbol with selected pen.
-X -Y
Shift origin of plot by (x-shift,y-shift). Prepend a
for absolute coordinates; the default (r) will reset
plot origin.
-Z For 3-D projections: Sets the z-level of the basemap
[0].
-: Toggles between (longitude,latitude) and
(latitude,longitude) input/output. [Default is
(longitude,latitude)].
-c Specifies the number of plot copies. [Default is 1]
-bi Selects binary input. Append s for single precision
[Default is double]. Append n for the number of
columns in the binary file(s). [Default is the
required number of columns given the settings].
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 southeast at 30 degree eleva-
tion, try:
psxyz heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c
-So1.25c -G0/0/255 -B2:XLABEL:/2:YLABEL:/10:ZLABEL::."3-D
PLOT":15 -E135/30 -Uc -W -P > heights.ps
BUGS
No hidden line removal is employed for polygons and lines.
Symbols, however, are first sorted according to their dis-
tance from the viewpoint so that nearby symbols will over-
print more distant ones should they project to the same x,y
position.
The -N option does not adjust the BoundingBox information so
you may have to post-process the PostScript outout with
epstool or ps2epsi to obtain a correct BoundingBox.
SEE ALSO
gmt(l), psbasemap(l), psxy(l)