psxy - Plot lines, polygons, and symbols on maps

psxyfiles-Jparameters-Rwest/east/south/north[r] [-A] [-Btickinfo] [-Ccptfile] [-E[x][y][cap][/pen] ] [-Gfill] [-H[nrec] ] [-K] [-L] [-N] [-M[flag] ] [-O] [-P] [-S[symbol][size] ] [-U[/dx/dy/][label] ] [-V] [-W[pen] ] [-Xx-shift] [-Yy-shift] [-:] [-ccopies] [-bi[s][n] ]

psxyreads (x,y) pairs fromfiles[or standard input] and generatesPostScriptcode that will plot lines, polygons, or symbols at those locations on a map. If a symbol is selected and no symbol size given, then psxy will interpret the third 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-Sis not selected, a line connecting the data points will be drawn instead. 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,psxywill 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.-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.-ASuppress drawing line segments as great circle Arcs. [Default draws great circle arcs.]-BSets map boundary tickmark intervals. Seepsbasemapfor details.-CGive a color palette file and let symbol color be determined by the z-value in the third column. Must be used with-S. If used, then additional fields are shifted over by one column (optional size would be 4th rather than 3rd field, etc.).-EDraw error bars. Appendxand/oryto indicate which bars you want to draw. The x and/or y errors must be stored in the columns after the (x,y) pair [or (x,y,size) triplet]. Thecapparameter indicates the length of the end-cap on the error bars in inch [0.1i]. Pen attributes for error bars may also be set. [Defaults: width = 1, color = 0/0/0, texture = solid].-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,psxywill 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: connect the endpoints of the line- segment(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. If present,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 the circle, while the corresponding lowercase symbols all are circumscribed by the circle. Choose between these symbol codes:-SRead symbol code (see below) from last column in the input data. Cannot be used in conjunction with-b. Optionally, appendc,i,m,pto indicate that the size information in the input data is in units of cm, inch, meter, or point, respectively. [Default is MEASURE_UNIT].-Sastar.sizeis diameter of circumscribing circle.-Sbbar extending frombaseto y.sizeis bar width. Appenduifsizeis in x-units [Default is inch]. By default,base= 0. Appendbbaseto change this value.-Sccircle.sizeis diameter of circle.-Sddiamond.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 3, 4, and 5.-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 *.-Sppoint. No size needs to be specified (1 pixel is used).-Sssquare.sizeis diameter of circumscribing circle.-Sttriangle.sizeis diameter of circumscribing circle.-Svvector. Direction (in degrees counterclockwise from horizontal) and length (in inch) must be found in columns 3 and 4.size, if present, will be interpreted as arrowwidth/headlength/headwidth (in 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 (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 (-Svleaves the directions unchanged.)-Sxcross.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 symbols 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.-: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 chosen settings].

To plot solid red circles (diameter = 0.1 inch) at the positions listed in the file DSDP.xy on a Mercator map at 2 inch/degree of the area 150E to 154E, 18N to 23N, with tickmarks every 1 degree and gridlines every 15 minutes, try: psxy DSDP.xy-R150/154/18/23-Jm2i-Sc0.1i-G255/0/0-B1g15m| lpr To plot the xyz values in the file quakes.xyzm as circles with size given by the magnitude in the 4th column and color based on the depth in the third using the color palette cpt on a linear map, try psxy quakes.xyzm-R0/1000/0/1000-JX6i-Sc-Ccpt-B200 > map.ps To plot the file trench.xy on a Mercator map, with white triangles with sides 0.1 inch on the left side of the line, spaced every 0.8 inch, use psxy trench.xy-R150/200/20/50-Jm0.15i-Sf0.8i/0.1iL-G255-W-B10 | lpr br To plot the data in the file misc.d as symbols determined by the code in the last column, and with size given by the magnitude in the 4th column, and color based on the third column via the color palette cpt on a linear map, try psxy misc.d-R0/100/-50/100-JX6i-S-Ccpt-B20 > t.ps

gmt, psbasemap, psxyz

Man(1) output converted with man2html