.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: proc vector</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>proc vector</h2></td>
  <td align=right>
  <small>
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="../doc/Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH proc_vector PL "20-MAY-2003   PL ploticus.sourceforge.net"

.ig >>
<center>
<img src="../gallery/vector0.gif">
</center>
.>>

.SH DESCRIPTION
Display a group of vectors.
Vectors allow the display of up to 4 variables (x, y, direction, 
and length).
Version 2.11+ adds wind barb capability.

.ig >>
<br><br><br>
.>>
.SH EXAMPLES
.ig >>
<a href="../gallery/gall.vector.html">
.>>
\0Gallery examples
.ig >>
</a>
.>>

.ig >>
<br><br><br>
.>>
.SH ATTRIBUTES
Mandatory attributes are 
\fCxfield\fR, 
\fCyfield\fR, and
\fCdirfield\fR.

.ig >>
<br><br>
.>>
.LP
\fBtype\fR \fCarrow | barb\fR
.IP \0
Controls the type of vector to draw, either arrows (the default) or wind barbs.

.ig >>
<br><br>
.>>

.LP
\fBxfield\fR
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field holding the X location of vector starting point.

.ig >>
<br><br>
.>>
.LP
\fByfield\fR
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field holding the Y location of the vector starting point.

.ig >>
<br><br>
.>>
.LP
\fBdirfield\fR
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field holding a representation of the direction.
By default this is degrees, where 0 is at the top, and rotating clockwise,
but other options are available, see \fCdirunits\fR, \fCdirrange\fR, \fCzeroat\fR, and \fCclockdir\fR.

.ig >>
<br><br>
.>>
.LP
\fBmagfield\fR
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.br
\fBlenfield\fR
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field holding a representation of the magnitude or length of the vector.
By default this is in absolute units (inches or cm),
but other options are available, see \fClenunits\fR and \fClenscale\fR.
\fBlenfield\fR is an alias to \fBmagfield\fR.

.ig >>
<br><br>
.>>
.LP
\fBconstantlen\fR \fIh\fR
.IP \0
This attribute may be specified to cause all vectors to be \fIh\fR inches/cm.
.br
Example: \fCconstantlen: 0.6\fR

.ig >>
<br><br>
.>>
.LP
\fBlinedetails\fR
.ig >>
<a href="linedetails.html">
.>>
\0line details
.ig >>
</a>
.>>
.IP \0
Controls the color, width, etc. of the line portion of the vector.

.ig >>
<br><br>
.>>
.LP
\fBarrowheadlength\fI h \fR
.IP \0
Controls the length of the arrowhead, in inches/cm.  Default is \fC0.15\fR.

.ig >>
<br><br>
.>>
.LP
\fBarrowheadwidth\fI h \fR
.IP \0
Controls the fatness of the arrowhead.  Default is \fC0.4\fR.

.ig >>
<br><br>
.>>
.LP
\fBarrowheadcolor\fI color \fR
.IP \0
Controls the color of the arrowhead.  By default this will be the
same as the line.

.ig >>
<br><br>
.>>
.LP
\fBclip\fR \fCyes|no\fR
.IP \0
Default is \fCyes\fR, which causes vectors to be clipped to the plotting area.
Use \fCno\fR to allow vectors to range past the plot area limits.

.ig >>
<br><br>
.>>
.LP
\fBdirrange\fR \fIh\fR
.IP \0
A range for the values in \fCdirfield\fR.  For example, if \fCdirrange\fR is given
as \fC100\fR, a value of \fC50\fR would be displayed at 180 degrees.
.br
Example: \fCdirrange: 12\fR

.ig >>
<br><br>
.>>
.LP
\fBdirunits\fR \fCdegrees|radians\fR
.IP \0
Default is \fCdegrees\fR.  If \fCradians\fR is specified, 
\fCdirfield\fR is taken to be radians.
.br
Example: \fCdirunits: radians\fR

.ig >>
<br><br>
.>>
.LP
\fBzeroat\fR \fCtop|right|bottom|right\fR
.IP \0
Controls where a zero degree vector will point.  Default is \fCtop\fR.

.ig >>
<br><br>
.>>
.LP
\fBclockdir\fR \fC+|-\fR
.IP \0
Controls whether progressively higher directional values will
cause the vector to move clockwise (\fC+\fR) or counterclockwise (\fC-\fR).
Default is \fC+\fR.

.ig >>
<br><br>
.>>
.LP
\fBlenunits\fC  absolute|data|x|y
.IP \0
Allows the contents of \fClenfield\fR to be either \fCabsolute\fR units (the default),
or \fCdata\fR units.

.ig >>
<br><br>
.>>
.LP
\fBlenscale\fI h\fR
.IP \0
\fIh\fR is a scaling factor;  the contents of \fClenfield\fR will be
multiplied by \fIh\fR.  Default is \fC1.0\fR.

.ig >>
<br><br>
.>>
.LP
\fBcolorfield\fR
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
If specified, the color of the vector will be controlled using 
the contents of this data field, using the
.ig >>
<a href="legendentry.html#legenddriven">
.>>
\0legend-driven technique
.ig >>
</a>
.>>
.br
Example:
.ig >>
<a href="../gallery/vector3.htm">
.>>
\0vector3
.ig >>
</a>
.>>


.ig >>
<br><br>
.>>
.LP
\fBselect\fR
.ig >>
<a href="condex.html">
.>>
\0condex
.ig >>
</a>
.>>
.IP \0
Select certain records for plotting, based on a conditional expression.

.ig >>
<br><br>
.>>
.LP
\fBlegendlabel\fR \fIlabel\fR
.IP \0
Set a legend label for this set of vectors.  Legend must be displayed
later using proc legend.

.ig >>
<br><br><br>
.>>
.SH Pertaining to wind barbs

Set \fCtype\fR to \fCbarb\fR.
For best results, use constantlen to set the size of the barb's stem.

.ig >>
<br><br>
.>>

.LP
\fBbarblimits\fR \fI big medium small tiny \fR
.IP \0
Sets the limits for drawing different sized barbs on the stem of a wind
barb.  The default for the big triangular barb is 50,  the medium sized
(full length, 1 line) barb is 10, small sized barb (half length) is 5,
tiny barbs are just the stem drawn half length is 2.  The tiny barbs are
not the official way to show very low wind, which normally is to draw a
dot instead, which can be done using a scatterplot and a few selects.
.br
Example: \fCbarblimits: 40 12 8 2\fR

.ig >>
<br><br>
.>>

.LP
\fBbarbdir\fR \fId\fR
.IP \0
The angle the barbs are drawn relative to the stem, in degrees.  Default is 120.



.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/Welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
.>>

