The SGPLOT Procedure

VECTOR Statement

Creates a vector plot that draws arrows from a point of origin to each data point.

Restriction:

This statement is available with SAS 9.2 Phase 2 and later.

VECTOR X= numeric-variable Y= numeric-variable </ option(s)>;

option(s) can be one or more of the following:

Vector options:

	ARROWDIRECTION= OUT \| IN \| BOTH
	ARROWHEADSHAPE= shape
	DATALABEL <= variable>
	LINEATTRS= style-element <(options)> \| (options)
	NOARROWHEADS
	NOMISSINGGROUP
	XORIGIN= numeric-value \| numeric-variable
	YORIGIN= numeric-value \| numeric-variable

Plot options:

GROUP= variable

LEGENDLABEL= "text-string"

NAME= "text-string"

TRANSPARENCY= numeric-value

X2AXIS

Y2AXIS

Required Arguments

X= numeric-variable: specifies a numeric variable for the x axis.
Y= numeric-variable: specifies numeric variable for the y axis.

Options

ARROWDIRECTION= IN | OUT | BOTH

specifies the location of the arrowheads for the vectors. Specify one of the following:

IN	places the arrowheads at the origin of the vector.
OUT	places the arrowheads at the ending point of the vector.
BOTH	places arrowheads at both the origin and the ending point of the vector.

Default:

OUT

ARROWHEADSHAPE= shape

specifies the shape of the arrowheads for the vectors. Specify one of the following:

OPEN	resembles the letter "V".
CLOSED	an outline of a triangle.
FILLED	a solid triangle.
BARBED	a solid triangle with an indent at the base.

Default:

OPEN

DATALABEL <= variable>

displays a label for each data point. If you specify a variable, then the values of that variable are used for the data labels. If you do not specify a variable, then the values of the Y variable are used for the data labels.

GROUP= variable

specifies a variable that is used to group the data. A separate plot is created for each unique value of the grouping variable. The plot elements for each group value are automatically distinguished by different visual attributes.

LEGENDLABEL= "text-string"

specifies a label that identifies the vector plot in the legend. By default, the label of the Y variable or the group value for each plot element is used.

Interaction:

The LEGENDLABEL= option has no effect if you also specify the GROUP= option in the same plot statement.

LINEATTRS= style-element <(options)> | (options)

specifies the appearance of the vector line. You can specify the appearance by using a style element or by using suboptions. If you specify a style element, you can additionally specify suboptions to override specific appearance attributes.

options can be one or more of the following:

COLOR= color

specifies the color of the line. For more information about specifying colors, see SAS/GRAPH Colors and Images in the SAS/GRAPH: Reference, Second Edition.

Default:

For ungrouped data, the default color is specified by the ContrastColor attribute of the GraphDataDefault style element in the current style.

For grouped data, the default color is specified by the ContrastColor attribute of the GraphData1 ... GraphDatan style elements in the current style.

PATTERN= line-pattern

specifies the line pattern for the line. You can reference SAS patterns by number or by name. See Line Patterns for a list of line patterns.

Default:

For ungrouped data, the default line pattern is specified by the LineStyle attribute of the GraphDataDefault style element in the current style.

For grouped data, the default line pattern is specified by the LineStyle attribute of the GraphData1 ... GraphDatan style elements in the current style.

THICKNESS= n <units>

specifies the thickness of the line. You can also specify the unit of measure. The default unit is pixels. See Units of Measurement for a list of the measurement units that are supported.

Default:

For ungrouped data, the default line thickness is specified by the LineThickness attribute of the GraphDataDefault style element in the current style.

For grouped data, the default line thickness is specified by the LineThickness attribute of the GraphData1 ... GraphDatan style elements in the current style.

NAME= "text-string"

specifies a name for the plot. You can use the name to refer to this plot in other statements.

NOARROWHEADS

removes the arrowheads from the vectors.

NOMISSINGGROUP

specifies that missing values of the group variable are not included in the plot.

TRANSPARENCY= numeric-value

specifies the degree of transparency for the lines. Specify a value from 0.0 (completely opaque) to 1.0 (completely transparent).

Default:

0.0

X2AXIS

assigns the X variable to the secondary (top) horizontal axis.

XORIGIN= numeric-value | numeric-variable

specifies the X coordinate of the origin for the vectors. You can specify either a numeric value or a numeric variable.

Default:

Y2AXIS

assigns the Y variable to the secondary (right) vertical axis.

YORIGIN= numeric-value | numeric-variable

specifies the Y coordinate of the origin for the vectors. You can specify either a numeric value or a numeric variable.

Default:

Top of Page

	GROUP= variable
	LEGENDLABEL= "text-string"
	NAME= "text-string"
	TRANSPARENCY= numeric-value
	X2AXIS
	Y2AXIS