diff -uNr GMT3.4.2.orig/man/manl/grdbarb.l GMT3.4.2/man/manl/grdbarb.l --- GMT3.4.2.orig/man/manl/grdbarb.l Thu Jan 1 09:00:00 1970 +++ GMT3.4.2/man/manl/grdbarb.l Thu Feb 13 18:00:03 2003 @@ -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.2.orig/man/manl/psxy.l GMT3.4.2/man/manl/psxy.l --- GMT3.4.2.orig/man/manl/psxy.l Thu Oct 3 02:25:53 2002 +++ GMT3.4.2/man/manl/psxy.l Thu Feb 13 18:03:43 2003 @@ -225,6 +225,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