proc vector


Welcome     Gallery     Handbook


Manual page for proc_vector(PL)

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.


EXAMPLES

Gallery examples


ATTRIBUTES

Mandatory attributes are xfield, yfield, and dirfield.

type arrow | barb

Controls the type of vector to draw, either arrows (the default) or wind barbs.

xfield dfield

Data field holding the X location of vector starting point.

yfield dfield

Data field holding the Y location of the vector starting point.

dirfield dfield

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 dirunits, dirrange, zeroat, and clockdir.

magfield dfield
lenfield dfield

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 lenunits and lenscale. lenfield is an alias to magfield.

constantlen h

This attribute may be specified to cause all vectors to be h inches/cm.
Example: constantlen: 0.6

linedetails line details

Controls the color, width, etc. of the line portion of the vector.

arrowheadlength h

Controls the length of the arrowhead, in inches/cm. Default is 0.15.

arrowheadwidth h

Controls the fatness of the arrowhead. Default is 0.4.

arrowheadcolor color

Controls the color of the arrowhead. By default this will be the same as the line.

clip yes|no

Default is yes, which causes vectors to be clipped to the plotting area. Use no to allow vectors to range past the plot area limits.

dirrange h

A range for the values in dirfield. For example, if dirrange is given as 100, a value of 50 would be displayed at 180 degrees.
Example: dirrange: 12

dirunits degrees|radians

Default is degrees. If radians is specified, dirfield is taken to be radians.
Example: dirunits: radians

zeroat top|right|bottom|right

Controls where a zero degree vector will point. Default is top.

clockdir +|-

Controls whether progressively higher directional values will cause the vector to move clockwise (+) or counterclockwise (-). Default is +.

lenunits absolute|data|x|y

Allows the contents of lenfield to be either absolute units (the default), or data units.

lenscale h

h is a scaling factor; the contents of lenfield will be multiplied by h. Default is 1.0.

colorfield dfield

If specified, the color of the vector will be controlled using the contents of this data field, using the legend-driven technique
Example: vector3

select condex

Select certain records for plotting, based on a conditional expression.

legendlabel label

Set a legend label for this set of vectors. Legend must be displayed later using proc legend.


Pertaining to wind barbs

Set type to barb. For best results, use constantlen to set the size of the barb's stem.

barblimits big medium small tiny

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.
Example: barblimits: 40 12 8 2

barbdir d

The angle the barbs are drawn relative to the stem, in degrees. Default is 120.


data display engine  
Copyright Steve Grubb


Markup created by unroff 1.0,    May 20, 2003.