diff -uNr GMT3.4.4.orig/man/manl/grdbarb.l GMT3.4.4/man/manl/grdbarb.l --- GMT3.4.4.orig/man/manl/grdbarb.l 1970-01-01 09:00:00.000000000 +0900 +++ GMT3.4.4/man/manl/grdbarb.l 2004-01-29 03:25:16.000000000 +0900 @@ -0,0 +1,185 @@ +.TH GRDVECTOR l "1 Mar 2002" +.SH NAME +grdbarb \- Plot wind barb fields from grdfiles +.SH SYNOPSIS +\fBgrdbarb\fP \fIcompx.grd\fP \fIcompy.grd\fP \fB\-J\fP\fIparameters\fP [ \fB\-A\fP ] +[ \fB\-B\fP\fItickinfo\fP ] [ \fB\-E\fP ] +[ \fB\-I\fP\fIx_inc\fP[\fBm|c\fP][/\fIy_inc\fP[\fBm|c\fP]] ] [ \fB\-K\fP ] [ \fB\-N\fP ] [ \fB\-O\fP ] [ \fB\-P\fP ] +[ \fB\-Q\fP\fIparameters\fP ] [ \fB\-R\fP\fIwest/east/south/north\fP[\fBr\fP] ] +[ \fB\-T\fP ] [ \fB\-U\fP[\fI/dx/dy/\fP][\fIlabel\fP] ] [ \fB\-V\fP ] [ \fB\-W\fP\fIcontourpen\fP ] [ \fB\-X\fP\fIx-shift\fP ] +[ \fB\-Y\fP\fIy-shift\fP ] [ \fB\-Z\fP ] [ \fB\-c\fP\fIcopies\fP ] +.SH DESCRIPTION +\fBgrdbarb\fP reads two 2-D gridded files which represents the x- and y-components of a vector field and +produces a wind barb field plot by +drawing barbs with orientation and length according to the information in the files. Alternatively, +polar coordinate components may be used (r, theta). +.TP +\fIcompx.grd\fP +Contains the x-component of the vector field. +.TP +\fIcompy.grd\fP +Contains the y-component of the vector field. +.TP +.B \-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 setting in .gmtdefaults, but this can be +overridden on the command line by appending the c, i, or m to the scale/width value. +.br +.sp +\fBCYLINDRICAL PROJECTIONS:\fP +.br +.sp +\fB\-Jc\fP\fIlon0/lat0/scale\fP (Cassini) +.br +\fB\-Jj\fP\fIlon0/scale\fP (Miller) +.br +\fB\-Jm\fP\fIscale\fP (Mercator - Greenwich and Equator as origin) +.br +\fB\-Jm\fP\fIlon0/lat0/scale\fP (Mercator - Give meridian and standard parallel) +.br +\fB\-Joa\fP\fIlon0/lat0/azimuth/scale\fP (Oblique Mercator - point and azimuth) +.br +\fB\-Job\fP\fIlon0/lat0/lon1/lat1/scale\fP (Oblique Mercator - two points) +.br +\fB\-Joc\fP\fIlon0/lat0/lonp/latp/scale\fP (Oblique Mercator - point and pole) +.br +\fB\-Jq\fP\fIlon0/scale\fP (Equidistant Cylindrical Projection (Plate Carree)) +.br +\fB\-Jt\fP\fIlon0/scale\fP (TM - Transverse Mercator, with Equator as y = 0) +.br +\fB\-Jt\fP\fIlon0/lat0/scale\fP (TM - Transverse Mercator, set origin) +.br +\fB\-Ju\fP\fIzone/scale\fP (UTM - Universal Transverse Mercator) +.br +\fB\-Jy\fP\fIlon0/lats/scale\fP (Basic Cylindrical Projection) +.br +.sp +\fBAZIMUTHAL PROJECTIONS:\fP +.br +.sp +\fB\-Ja\fP\fIlon0/lat0/scale\fP (Lambert). +.br +\fB\-Je\fP\fIlon0/lat0/scale\fP (Equidistant). +.br +\fB\-Jf\fP\fIlon0/lat0/horizon/scale\fP (Gnomonic). +.br +\fB\-Jg\fP\fIlon0/lat0/scale\fP (Orthographic). +.br +\fB\-Js\fP\fIlon0/lat0/\fP[\fIslat/\fP]\fIscale\fP (General Stereographic) +.br +.sp +\fBCONIC PROJECTIONS:\fP +.br +.sp +\fB\-Jb\fP\fIlon0/lat0/lat1/lat2/scale\fP (Albers) +.br +\fB\-Jd\fP\fIlon0/lat0/lat1/lat2/scale\fP (Equidistant) +.br +\fB\-Jl\fP\fIlon0/lat0/lat1/lat2/scale\fP (Lambert) +.br +.sp +\fBMISCELLANEOUS PROJECTIONS:\fP +.br +.sp +\fB\-Jh\fP\fIlon0/scale\fP (Hammer) +.br +\fB\-Ji\fP\fIlon0/scale\fP (Sinusoidal) +.br +\fB\-Jk\fP[\fBf|s\fP]\fIlon0/scale\fP (Eckert IV (f) and VI (s)) +.br +\fB\-Jn\fP\fIlon0/scale\fP (Robinson) +.br +\fB\-Jr\fP\fIlon0/scale\fP (Winkel Tripel) +.br +\fB\-Jv\fP\fIlon0/scale\fP (Van der Grinten) +.br +\fB\-Jw\fP\fIlon0/scale\fP (Mollweide) +.br +.sp +\fBNON-GEOGRAPHICAL PROJECTIONS:\fP +.br +.sp +\fB\-Jp\fP[\fBa\fP]\fIscale\fP[\fI/origin\fP] (polar (theta,r) coordinates, optional \fBa\fP for azimuths and offset theta [0]) +.br +\fB\-Jx\fP\fIx-scale\fP[\fBl|p\fP\fIpow\fP][\fI/y-scale\fP[\fBl|p\fP\fIpow\fP]] (Linear, log, and power scaling) +.br +More details can be found in the \fBpsbasemap\fP manpages. +.br +.SH OPTIONS +No space between the option flag and the associated arguments. +.TP +.B \-A +Means grdfiles have polar (r, theta) components instead of Cartesian (x, y). +.TP +.B \-B +Sets map boundary tickmark intervals. See \fBpsbasemap\fP for details. +.TP +.B \-E +Center vectors on grid nodes [Default draws from grid node]. +.TP +.B \-I +Only plot vectors at nodes every \fIx_inc, y_inc\fP apart (must be multiples of +original grid spacing). Append \fBm\fP for minutes or \fBc\fP for seconds. [Default plots every node]. +.TP +.B \-K +More \fIPostScript\fP code will be appended later [Default terminates the plot system]. +.TP +.B \-N +Do NOT clip vectors at map boundaries [Default will clip]. +.TP +.B \-O +Selects Overlay plot mode [Default initializes a new plot system]. +.TP +.B \-P +Selects Portrait plotting mode [\fBGMT\fP Default is Landscape, see gmtdefaults to change this]. +.TP +.B \-Q +Select barb plot. Optionally, specify \fIparameters\fP which +are \fIbarbwidth/barblength/barbangle/barbscale\fP [Default is 0.1\fBi\fP/0.2\fBi\fP/120/5]. +.TP +.B \-R +\fIwest, east, south,\fP and \fInorth\fP specify the Region of interest. To specify boundaries +in degrees and minutes [and seconds], use the dd:mm[:ss] format. Append \fBr\fP if lower left and upper right +map coordinates are given instead of wesn. +Specify a subset of the grid. +.TP +.B \-T +Means azimuth should be converted to angles based on the selected map projection. +.TP +.B \-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 \fBc\fP (which will plot the command string.). The GMT parameters +UNIX_TIME and UNIX_TIME_POS can affect the appearance; see the \fBgmtdefaults\fP man +page for details. +.TP +.B \-V +Selects verbose mode, which will send progress reports to stderr [Default runs "silently"]. +.TP +.B \-W +Set pen attributes used for vector outlines [Default: width = 1, color = 0/0/0, texture = solid]. +.TP +.B \-X \-Y +Shift origin of plot by (\fIx-shift,y-shift\fP). +Prepend \fBa\fP for absolute coordinates; +the default (\fBr\fP) will reset plot origin. +.TP +.B \-Z +Means the angles provided are azimuths rather than direction (requires \fB\-A\fP). +.TP +.B \-c +Specifies the number of plot copies. [Default is 1] +.SH EXAMPLES +To draw the vector field given by the files r.grd and theta.grd on a linear plot +with scale 5 cm per data unit, +using vector rather than stick plot, and scale vector magnitudes so that 10 units +equal 1 inch, try +.br +.sp +grdvector r.grd theta.grd \fB\-Jx\fP5\fBc\fP \fB\-Q\fP \fB\-S\fP10\fBi\fP > gradient.ps +.br +.sp +.SH "SEE ALSO" +.IR gmt (l), +.IR grdcontour (l), +.IR psxy (l) diff -uNr GMT3.4.4.orig/man/manl/psxy.l GMT3.4.4/man/manl/psxy.l --- GMT3.4.4.orig/man/manl/psxy.l 2004-01-11 11:15:41.000000000 +0900 +++ GMT3.4.4/man/manl/psxy.l 2004-01-29 03:25:16.000000000 +0900 @@ -226,6 +226,16 @@ .B \-Sp \fBp\fPoint. No size needs to be specified (1 pixel is used). .TP +.B \-Sr +\fBw\fPind barb. Direction (in degrees counter-clockwise from horizontal) and length must be found in columns 3 and 4. \fIsize\fP, +if present, will be interpreted as barbwidth/barblength/barbangle/barbscale [Default is 0.1\fBi\fP/0.2\fBi\fP/120/5]. +.TP +.B \-SR +Same as \fB\-Sr\fP, 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 (\fB\-Sr\fP leaves the directions +unchanged.) +.TP +.B \-Ss .B \-Ss \fBs\fPquare. \fIsize\fP is diameter of circumscribing circle. .TP diff -uNr GMT3.4.4.orig/man/manl/psxy.l.orig GMT3.4.4/man/manl/psxy.l.orig --- GMT3.4.4.orig/man/manl/psxy.l.orig 1970-01-01 09:00:00.000000000 +0900 +++ GMT3.4.4/man/manl/psxy.l.orig 2004-01-11 11:15:41.000000000 +0900 @@ -0,0 +1,324 @@ +.TH PSXY l "1 Jan 2004" +.SH NAME +psxy \- Plot lines, polygons, and symbols on maps +.SH SYNOPSIS +\fBpsxy\fP \fIfiles\fP \fB\-J\fP\fIparameters\fP \fB\-R\fP\fIwest/east/south/north\fP[\fBr\fP] +[ \fB\-A\fP ] [ \fB\-B\fP\fItickinfo\fP ] [ \fB\-C\fP\fIcptfile\fP ] [ \fB\-E\fP[\fBx|y|X|Y\fP][\fIcap\fP][\fP/pen\fP] ] +[ \fB\-G\fP\fIfill\fP ] [ \fB\-H\fP[\fInrec\fP] ] [ \fB\-K\fP ] [ \fB\-L\fP ] +[ \fB\-N\fP ] [ \fB\-M\fP[\fIflag\fP] ] [ \fB\-O\fP ] [ \fB\-P\fP ] [ \fB\-S\fP[\fIsymbol\fP][\fIsize\fP] ] [ \fB\-U\fP[\fI/dx/dy/\fP][\fIlabel\fP] ] +[ \fB\-V\fP ] [ \fB\-W\fP[\fIpen\fP] ] +[ \fB\-X\fP\fIx-shift\fP ] [ \fB\-Y\fP\fIy-shift\fP ] [ \fB\-:\fP ] [ \fB\-c\fP\fIcopies\fP ] [ \fB\-bi\fP[\fBs\fP][\fIn\fP] ] +.SH DESCRIPTION +\fBpsxy\fP reads (x,y) pairs from \fIfiles\fP [or standard input] and +generates \fIPostScript\fP code 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. Symbols whose size is <= 0 are skipped. If no symbols are specified then the symbol code (see \fB\-S\fP below) +must be present as last column in the input. Multiple segment files may be plotted using the \fB\-M\fP option. +If \fB\-S\fP is not selected, a line connecting the data points will be drawn instead. To +explicitly close polygons, use \fB\-L\fP. Select a shade with \fB\-G\fP. If \fB\-G\fP is set, \fB\-W\fP +will control whether the polygon outline is drawn or not. If a symbol is selected, \fB\-G\fP and +\fB\-W\fP determines the fill color and outline/no outline, respectively. +The \fIPostScript\fP code is written to standard output. +.TP +\fIfiles\fP +List one or more file-names. If no files are given, \fBpsxy\fP will read standard input. +.TP +.B \-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 setting in .gmtdefaults, but this can be +overridden on the command line by appending the c, i, or m to the scale/width value. +.br +.sp +\fBCYLINDRICAL PROJECTIONS:\fP +.br +.sp +\fB\-Jc\fP\fIlon0/lat0/scale\fP (Cassini) +.br +\fB\-Jj\fP\fIlon0/scale\fP (Miller) +.br +\fB\-Jm\fP\fIscale\fP (Mercator - Greenwich and Equator as origin) +.br +\fB\-Jm\fP\fIlon0/lat0/scale\fP (Mercator - Give meridian and standard parallel) +.br +\fB\-Joa\fP\fIlon0/lat0/azimuth/scale\fP (Oblique Mercator - point and azimuth) +.br +\fB\-Job\fP\fIlon0/lat0/lon1/lat1/scale\fP (Oblique Mercator - two points) +.br +\fB\-Joc\fP\fIlon0/lat0/lonp/latp/scale\fP (Oblique Mercator - point and pole) +.br +\fB\-Jq\fP\fIlon0/scale\fP (Equidistant Cylindrical Projection (Plate Carree)) +.br +\fB\-Jt\fP\fIlon0/scale\fP (TM - Transverse Mercator, with Equator as y = 0) +.br +\fB\-Jt\fP\fIlon0/lat0/scale\fP (TM - Transverse Mercator, set origin) +.br +\fB\-Ju\fP\fIzone/scale\fP (UTM - Universal Transverse Mercator) +.br +\fB\-Jy\fP\fIlon0/lats/scale\fP (Basic Cylindrical Projection) +.br +.sp +\fBAZIMUTHAL PROJECTIONS:\fP +.br +.sp +\fB\-Ja\fP\fIlon0/lat0/scale\fP (Lambert). +.br +\fB\-Je\fP\fIlon0/lat0/scale\fP (Equidistant). +.br +\fB\-Jf\fP\fIlon0/lat0/horizon/scale\fP (Gnomonic). +.br +\fB\-Jg\fP\fIlon0/lat0/scale\fP (Orthographic). +.br +\fB\-Js\fP\fIlon0/lat0/\fP[\fIslat/\fP]\fIscale\fP (General Stereographic) +.br +.sp +\fBCONIC PROJECTIONS:\fP +.br +.sp +\fB\-Jb\fP\fIlon0/lat0/lat1/lat2/scale\fP (Albers) +.br +\fB\-Jd\fP\fIlon0/lat0/lat1/lat2/scale\fP (Equidistant) +.br +\fB\-Jl\fP\fIlon0/lat0/lat1/lat2/scale\fP (Lambert) +.br +.sp +\fBMISCELLANEOUS PROJECTIONS:\fP +.br +.sp +\fB\-Jh\fP\fIlon0/scale\fP (Hammer) +.br +\fB\-Ji\fP\fIlon0/scale\fP (Sinusoidal) +.br +\fB\-Jk\fP[\fBf|s\fP]\fIlon0/scale\fP (Eckert IV (f) and VI (s)) +.br +\fB\-Jn\fP\fIlon0/scale\fP (Robinson) +.br +\fB\-Jr\fP\fIlon0/scale\fP (Winkel Tripel) +.br +\fB\-Jv\fP\fIlon0/scale\fP (Van der Grinten) +.br +\fB\-Jw\fP\fIlon0/scale\fP (Mollweide) +.br +.sp +\fBNON-GEOGRAPHICAL PROJECTIONS:\fP +.br +.sp +\fB\-Jp\fP[\fBa\fP]\fIscale\fP[\fI/origin\fP] (polar (theta,r) coordinates, optional \fBa\fP for azimuths and offset theta [0]) +.br +\fB\-Jx\fP\fIx-scale\fP[\fBl|p\fP\fIpow\fP][\fI/y-scale\fP[\fBl|p\fP\fIpow\fP]] (Linear, log, and power scaling) +.br +More details can be found in the \fBpsbasemap\fP manpages. +.br +.TP +.B \-R +\fIwest, east, south,\fP and \fInorth\fP specify the Region of interest. To specify boundaries +in degrees and minutes [and seconds], use the dd:mm[:ss] format. Append \fBr\fP if lower left and upper right +map coordinates are given instead of wesn. +.SH OPTIONS +No space between the option flag and the associated arguments. +.TP +.B \-A +Suppress drawing line segments as great circle Arcs. [Default draws great circle arcs.] +.TP +.B \-B +Sets map boundary tickmark intervals. See \fBpsbasemap\fP for details. +.TP +.B \-C +Give a color palette file. When used with -S, lets symbol color be determined by the z-value in the +third column. Additional fields are +shifted over by one column (optional size would be 4th rather than 3rd field, etc.). +If -S is not set, psxy expects the user to supply a multisegment polygon file (requires -M) and will look +for -Z\fIval\fP strings in each multisegment header. The \fIval\fP will control the color +via the cpt file. +.TP +.B \-E +Draw error bars. Append \fBx\fP and/or \fBy\fP to indicate which bars you want to draw (Default is both x and y). The x and/or +y errors must be stored in the columns after the (x,y) pair [or (x,y,size) triplet]. The +\fIcap\fP parameter indicates the length of the end-cap on the error bars [0.25c (or 0.1i)]. Pen +attributes for error bars may also be set. [Defaults: width = 1, color = 0/0/0, texture = solid]. If upper case +\fBX\fP and/or \fBY\fP is used we will instead draw "box-and-whisker" (or "stem-and-leaf") symbols. The x (or y) +coordinate is then taken as the median value, and 4 more columns are expected to contain the minimum (0% quartile), the 25% +quartile, the 75% quartile, and the maximum (100% quartile) values. The 25-75% box may be filled by using \fB\-G\fP. +.TP +.B \-G +Select filling of polygons and symbols. +Append the shade (0\-255), color (r/g/b), or \fBP\fP|\fBp\fP\fIdpi\fP/\fIpattern\fP (polygons only) [Default is no fill]. +Note when \fB\-M\fP is chosen, \fIpsxy\fP will search for \fB\-G\fP and \fB\-W\fP strings in all the subheaders and let any found values over-ride the command line settings. +.TP +.B \-H +Input file(s) has Header record(s). Number of header records can be changed by editing +your \.gmtdefaults file. If used, \fBGMT\fP default is 1 header record. +.TP +.B \-K +More \fIPostScript\fP code will be appended later [Default terminates the plot system]. +.TP +.B \-L +Force closed polygons: connect the endpoints of the line-segment(s) and draw polygons. +.TP +.B \-M +Multiple segment file. Segments are separated by a record whose first character is \fIflag\fP. +[Default is '>']. +.TP +.B \-N +Do NOT skip symbols that fall outside map border [Default plots points inside border only]. The +option does not apply to lines and polygons which are always clipped to the map region. +.TP +.B \-bo +Selects binary output. Append \fBs\fP for single precision [Default is double]. +.TP +.B \-P +Selects Portrait plotting mode [\fBGMT\fP Default is Landscape, see gmtdefaults to change this]. +.TP +.B \-S +Plot symbols. If present, \fIsize\fP is symbol size in the unit set in .gmtdefaults +(unless \fBc\fP, \fBi\fP, \fBm\fP, or \fBp\fP is appended). The uppercase symbols +\fBA, C, D, H, I, S, T\fP are 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: +.TP +.B \-S +Read symbol code (see below) from last column in the input data. Cannot be used in +conjunction with \fB\-b\fP. Optionally, append \fBc\fP, \fBi\fP, \fBm\fP, \fBp\fP to +indicate that the size information in the input data is in units of cm, inch, meter, +or point, respectively. [Default is MEASURE_UNIT]. +.TP +.B \-Sa +st\fBa\fPr. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-Sb +\fBb\fPar extending from \fIbase\fP to y. \fIsize\fP is bar width. Append \fBu\fP +if \fIsize\fP is in x-units [Default is plot-distance units]. By default, +\fIbase\fP = 0. Append \fBb\fP\fIbase\fP to change this value. +.TP +.B \-Sc +\fBc\fPircle. \fIsize\fP is diameter of circle. +.TP +.B \-Sd +\fBd\fPiamond. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-Se +\fBe\fPllipse. Direction (in degrees counter-clockwise from horizontal), major_axis, and minor_axis must be found in columns 3, 4, and 5. +.TP +.B \-SE +Same as \fB\-Se\fP, 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 (\fB\-Se\fP leaves the directions +unchanged.) Furthermore, the axes lengths must be given in km instead of plot-distance units. +.TP +.B \-Sf +\fBf\fPront. \fB\-Sf\fP\fIgap/size\fP[\fIdir\fP][\fItype\fP][:\fIoffset\fP]. Supply distance gap between symbols and symbol size. +If \fIgap\fP is negative, it is interpreted to mean the number of symbols along the front instead. Append \fIdir\fP to plot symbols +on the \fBl\fPeft or \fBr\fPight side of the front [Default is centered]. Append \fItype\fP to specify which symbol +to plot: \fBb\fPox, \fBc\fPircle, \fBf\fPault, \fBs\fPlip, or \fBt\fPriangle. [Default is fault]. +Slip means left-lateral or right-lateral strike-slip arrows (centered is not an option). Append :\fIoffset\fP to offset +the first symbol from the beginning of the front by that amount [Default is 0]. +.TP +.B \-Sh +\fBh\fPexagon. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-Si +\fBi\fPnverted triangle. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-Sl +\fBl\fPetter or text string (less than 64 characters). Give size, and append /\fIstring\fP 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 %\fIfont\fP +to select a particular font [Default is ANOT_FONT]. +.TP +.B \-Sp +\fBp\fPoint. No size needs to be specified (1 pixel is used). +.TP +.B \-Ss +\fBs\fPquare. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-St +\fBt\fPriangle. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-Sv +\fBv\fPector. Direction (in degrees counter-clockwise from horizontal) and length must be found in columns 3 and 4. \fIsize\fP, +if present, will be interpreted as arrowwidth/headlength/headwidth [Default is 0.075\fBc\fP/0.3\fBc\fP/0.25\fBc\fP (or 0.03\fBi\fP/0.12\fBi\fP/0.1\fBi\fP)]. +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 \fBn\fP\fInorm\fP, where vectors shorter than \fInorm\fP will have their +attributes scaled by length/\fInorm\fP. +.TP +.B \-SV +Same as \fB\-Sv\fP, 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 (\fB\-Sv\fP leaves the directions +unchanged.) +.TP +.B \-Sw +pie \fBw\fPedge. Start and stop directions (in degrees counter-clockwise from horizontal) for pie slice +must be found in columns 3 and 4. +.TP +.B \-Sx +cross. \fIsize\fP is diameter of circumscribing circle. +.TP +.B \-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 \fBc\fP (which will plot the command string.). The GMT parameters +UNIX_TIME and UNIX_TIME_POS can affect the appearance; see the \fBgmtdefaults\fP man +page for details. +.TP +.B \-V +Selects verbose mode, which will send progress reports to stderr [Default runs "silently"]. +.TP +.B \-W +Set pen attributes. [Defaults: width = 1, color = 0/0/0, texture = solid]. +Implicitly draws the outline of symbols with selected pen. +.TP +.B \-X \-Y +Shift origin of plot by (\fIx-shift,y-shift\fP). +Prepend \fBa\fP for absolute coordinates; +the default (\fBr\fP) will reset plot origin. +.TP +.B \-: +Toggles between (longitude,latitude) and (latitude,longitude) input/output. [Default is (longitude,latitude)]. +Applies to geographic coordinates only. +.TP +.B \-c +Specifies the number of plot copies. [Default is 1] +.TP +.B \-bi +Selects binary input. Append \fBs\fP for single precision [Default is double]. +Append \fIn\fP for the number of columns in the binary file(s). +[Default is the required number of columns given the chosen settings]. +.SH EXAMPLES +To plot solid red circles (diameter = 0.25 cm) at the positions listed in the file DSDP.xy on a +Mercator map at 5 cm/degree of the area 150E to 154E, 18N to 23N, with tickmarks every 1 degree +and gridlines every 15 minutes, try: +.br +.sp +psxy DSDP.xy \fB\-R\fP150/154/18/23 \fB\-Jm\fP5\fBc \-Sc\fP0.25\fBc\fP \fB\-G\fP255/0/0 \fB\-B\fP1\fBg\fP15\fBm\fP | lpr +.br +.sp +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 +.br +.sp +psxy quakes.xyzm \fB\-R\fP0/1000/0/1000 \fB\-JX\fP6\fBi\fP \fB\-Sc\fP \fB\-C\fPcpt \fB\-B\fP200 > map.ps +.br +.sp +To plot the file trench.xy on a Mercator map, with white triangles with sides 0.25 inch on the left +side of the line, spaced every 0.8 inch, use +.br +.sp +psxy trench.xy \fB\-R\fP150/200/20/50 \fB\-Jm\fP0.15\fBi \-Sf\fP0.8\fBi\fP/0.1\fBilt\fP \fB\-G\fP255 \fB\-W \-B\fP10 | lpr +br +.sp +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 +.br +.sp +psxy misc.d \fB\-R\fP0/100/-50/100 \fB\-JX\fP6\fBi\fP \fB\-S\fP \fB\-C\fPcpt \fB\-B\fP20 > t.ps +.SH BUGS +The \fB\-N\fP 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. +.br +\fBpsxy\fP 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 original polygon. +.SH "SEE ALSO" +.IR gmt (l), +.IR psbasemap (l), +.IR psxyz (l)