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

psxyzfiles-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]]

psxyzreads (x,y,z) triplets fromfiles[or standard input] and generatesPostScriptcode 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 in inch. If no symbols are specified then the symbol code (see-Sbelow) must be present as last column in the input. Multiple segment files may be plotted using the-Moption. If no symbols are selected, a line will be drawn. To explicitly close polygons, use-L. Select a shade with-G. If-Gis set,-Wwill control whether the polygon outline is drawn or not. If a symbol is selected,-Gand-Wdetermines the fill color and outline/no outline, respectively. ThePostScriptcode is written to standard output.filesList one or more file-names. If no files are given,psxyzwill read standard input.-JSelects the map projection. Scale is inch/degree, 1:xxxxx, or width in inch (upper case modifier).CYLINDRICALPROJECTIONS:-Jclon0/lat0/scale(Cassini)-Jjlon0/scale(Miller)-Jmscale(Mercator - Greenwich and Equator as origin)-Jmlon0/lat0/scale(Mercator - Give meridian and standard 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)-Juzone/scale(UTM - Universal Transverse Mercator)-Jylon0/lats/scale(Basic Cylindrical Projection)AZIMUTHALPROJECTIONS:-Jalon0/lat0/scale(Lambert).-Jelon0/lat0/scale(Equidistant).-Jflon0/lat0/horizon/scale(Gnomonic).-Jglon0/lat0/scale(Orthographic).-Jslon0/lat0/scale(General Stereographic)CONICPROJECTIONS:-Jblon0/lat0/lat1/lat2/scale(Albers)-Jllon0/lat0/lat1/lat2/scale(Lambert)MISCELLANEOUSPROJECTIONS:-Jhlon0/scale(Hammer)-Jilon0/scale(Sinusoidal)-Jklon0/scale(Eckert VI)-Jnlon0/scale(Robinson)-Jrlon0/scale(Winkel Tripel)-Jwlon0/scale(Mollweide)NON-GEOGRAPHICALPROJECTIONS:-Jpscale(Linear projection for polar (theta,r) coordinates)-Jxx-scale[l|ppow][/y-scale[l|ppow]] (Linear, log, and power scaling) More details can be found in thepsbasemapmanpages.-JzSets the vertical scaling (for 3-D maps). Same syntax as-Jx.-Rwest,east,south, andnorthspecify the Region of interest. To specify boundaries in degrees and minutes [and seconds], use the dd:mm[:ss] format. Appendrif lower left and upper right map coordinates are given instead of wesn.

No space between the option flag and the associated arguments.-BSets map boundary tickmark intervals. Seepsbasemapfor details.-CGive a color palette file and let symbol color be determined by the t-value in the fourth column. Must be used with-S. If used, then additional fields are shifted over by one column (optional size would be in 5th rather than 4th field, etc.).-ESets the viewpoint's azimuth and elevation [180/90].-GSelect filling of polygons and symbols. Append the shade (0-255), color (r/g/b), orp|pdpi/pattern(polygons only) [Default is no fill]. Note when-Mis chosen,psxyzwill search for-Gand-Wstrings in all the subheaders and let any found values over-ride the command line settings.-HInput file(s) has Header record(s). Number of header records can be changed by editing your .gmtdefaults file. If used,GMTdefault is 1 header record.-KMorePostScriptcode will be appended later [Default terminates the plot system].-LForce closed polygons: will connect the endpoints of the line- sement(s) and draw polygons.-MMultiple segment file. Segments are separated by a record whose first character isflag. [Default is '>'].-NDo NOT skip symbols that fall outside map border [Default plots points inside border only].-OSelects Overlay plot mode [Default initializes a new plot system].-PSelects Portrait plotting mode [GMTDefault is Landscape, see gmtdefaults to change this].-SPlot symbols.sizeis symbol size in inch (unlessc,i,m, orpis appended). The uppercase symbolsA,C,D,H,I,S,Tare normalized to have the same area as a circle of given size, while the corresponding lowercase symbols are circumscribed by the circle. Choose between:-Sastar.sizeis diameter of circumscribing circle.-Sb(b)ar extending frombaseto y.sizeis bar width. Appenduifsizeis in x-units [Default is inch]. By default,base= 0. Append bbaseto change this value.-Sc(c)ircle.sizeis diameter of circle.-Sd(d)iamond.sizeis diameter of circumscribing circle.-Seellipse. Direction (in degrees counterclockwise from horizontal), major_axis (in inch), and minor_axis (in inch) must be found in columns 4, 5, and 6.-SESame 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 (-Seleaves the directions unchanged.) Furthermore, the axes lengths must be given in km instead of inch.-Sffault. Give distance gap between ticks and ticklength in inch. If gap is negative, it is interpreted to mean number of ticks instead. Appendlorrto draw tick on the left or right side of line [Default is centered]. Upper caseLorRdraws a triangle instead of line segment.-Shhexagon.sizeis diameter of circumscribing circle.-Siinverted triangle.sizeis diameter of circumscribing circle.-Slletter or text string. Give size in inch, and append /stringafter the size. Note that the size is only approximate; no individual scaling is done for different characters. Remember to escape special characters like *.-Soc(o)lumn (3-D) extending frombaseto z.sizesets base width (Usexsize/ysizeif not the same). Appenduifsizeis in x- units [Default is inch]. By default,base= 0. Append bbaseto change this value.-Sp(p)oint. No size needs to be specified.-Ss(s)quare.sizeis diameter of circumscribing circle.-St(t)riangle.sizeis diameter of circumscribing circle.-Suc(u)be (3-D).sizesets length of all sides in inch. Appenduifsizeis in x-units [Default is inch].-Sv(v)ector. Direction and length (in inch) must be found in columns 4 and 5.sizemeansarrowwidth/headlength/headwidthin (inch) [[Default is 0.03i/0.12i/0.1iinch]. By default arrow attributes remains invariant to the length of the arrow. To have the size of the vector scale down with decreasing size, appendnnorm, where vectors shorter thannormwill have their attributes scaled by length/norm.-SVSame as-Sv, except azimuth should be given instead of direction. The azimuth will be mapped into an angle based on the chosen map projection (-Svleaves the directions unchanged.)-Sx(x)cross.sizeis diameter of circumscribing circle.-UDraw 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 in inch [Default is (-0.75i/- 0.75i)]. Optionally, append a label, orc(which will plot the command string.)-VSelects verbose mode, which will send progress reports to stderr [Default runs "silently"].-WSet pen attributes. [Defaults: width = 1, color = 0/0/0, texture = solid]. Implicitly draws the outline of symbol with selected pen.-X-YShift origin of plot by (x-shift,y-shift) inch [Default is (a1i,a1i) for new plots, (0,0) for overlays]. Prependafor absolute coordinates; the default (r) will reset plot origin.-ZFor 3-D projections: Sets the z-level of the basemap [0].-:Toggles between (longitude,latitude) and (latitude,longitude) input/output. [Default is (longitude,latitude)].-cSpecifies the number of plot copies. [Default is 1]-biSelects binary input. Appendsfor single precision [Default is double]. Appendnfor the number of columns in the binary file(s). [Default is the required number of columns given the settings].

To plot blue columns (width = 0.5 inch) 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 elevation, try: psxyz heights.xyz-R0/10/0/10/0/100-Jx0.5i-Jz0.05i-So0.5i-G0/0/255-B2:XLABEL:/2:YLABEL:/10:ZLABEL::."3-D PLOT":15-E135/30-Uc-W-P> heights.ps

No hidden line removal is employed for polygons and lines. Symbols, however, are first sorted according to their distance from the viewpoint so that nearby symbols will overprint more distant ones should they project to the same x,y position. Header must be plotted separately using pstext.

gmt, psbasemap, psxy

Man(1) output converted with man2html