The SGSCATTER Procedure

COMPARE Statement

Creates a comparative panel of scatter plots with shared axes.

Featured in:

Creating a Simple Comparative Panel, Creating a Comparative Panel with Regression Fits and Confidence Ellipses

Syntax

COMPARE X= variable | (variable-1 ... variable-n) Y= variable | (variable-1 ... variable-n) </options>;

options can be one or more of the following:

	DATALABEL <= variable>
	ELLIPSE <= (options)>
	GRID
	GROUP= variable
	JOIN <= (options)>
	LEGEND = (options)
	LOESS <= (options)>
	MARKERATTRS= style-element <(options)> \| (options)
	NOLEGEND
	PBSPLINE <= (options)>
	REFTICKS
	REG <= (options)>
	SPACING= n
	TRANSPARENCY= numeric-value

Required Options

X= variable | (variable-1) ... (variable-n): specifies one or more variables for the X axis. To specify more than one variable, enclose the list of variables in parentheses.
Y= variable | (variable-1) ... (variable-n): specifies the one or more variables for the Y axis. To specify more than one variable, enclose the list of variables in parentheses.

Options

DATALABEL <= variable>

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

ELLIPSE <= (options) >

Adds a confidence or prediction ellipse to the scatter plot.

options can be one or more of the following:

ALPHA= numeric-value

specifies the confidence level for the ellipse. Specify a number between 0.00 (100% confidence) and 1.00 (0% confidence).

Default:

.05

TYPE= MEAN | PREDICTED

specifies the type of ellipse. MEAN specifies a confidence ellipse for the population mean. PREDICTED specifies a prediction ellipse for a new observation. Both ellipse types assume bivariate normal distribution.

Default:

PREDICTED

Interaction:	The GROUP option does not affect the creation of ellipses. The SGSCATTER procedure always uses all of the data points to calculate the confidence or prediction ellipse.
Restriction:	To use this option, all of the X and Y variables must be numeric.

GRID

creates grid lines for each tick on both axes.

GROUP= variable

specifies a classification variable to divide the values into groups. If a fit line is requested, then the GROUP= variable is also applied to the fit plot unless you specify the NOGROUP suboption in the option for the fit plot.

JOIN <= (options)>

specifies that line segments join all of the scatter points. The line segments connect the scatter points in increasing order along the X axis. The data order of the input data set has no effect on the order of the lines.

You can specify the following options:

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

specifies the appearance of the join lines. 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 GraphFit 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 GraphFit 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 GraphFit 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.

Restriction:

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

LEGEND= (options)

specifies the appearance of the legend for the scatter plot.

options can be one or more of the following:

ACROSS= n

specifies the number of columns in the legend.

DOWN= n

specifies the number of columns in the legend.

Interaction:

If you specify both the ACROSS= and DOWN= suboptions, then the DOWN= suboption has no effect.

NOBORDER

removes the border from the legend.

NOTITLE

removes the label from the legend.

POSITION= position-value

specifies the position of the legend within the graph. The positions are as follows:

BOTTOM	places the legend at the bottom of the graph.
LEFT	places the legend at the left side of the graph.
RIGHT	places the legend at the right side of the graph.
TOP	places the legend at the top of the graph.

Note: If you specify more than one legend with the same position, then all of your legends are placed at that position. [cautionend]

Default:

BOTTOM

TITLE= "text-sting"

specifies the label for the legend. By default, the label of the group variable is used.

LOESS <= (options)>

Adds a loess fit to the scatter plot. You can specify the following options:

ALPHA= numeric-value

specifies the confidence level for the confidence limits. Specify a number between 0.00 (100% confidence) and 1.00 (0% confidence).

Note: This option has no effect if you do not specify the CLM option. [cautionend]

Default:

.05

CLM

creates confidence limits for a mean predicted value for each observation.

DEGREE= 1 | 2

specifies the degree of the local polynomials to use for each local regression. 1 specifies a linear fit and 2 specifies a quadratic fit.

Default:

INTERPOLATION= CUBIC | LINEAR

specifies the degree of the interpolating polynomials that are used for blending local polynomial fits at the kd tree vertices.

Default:

CUBIC

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

specifies the appearance of the fit 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 GraphFit 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 GraphFit 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 GraphFit 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.

Restriction:

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

NOGROUP

specifies that the fit does not use the group variable from the scatter plot.

SMOOTH= numeric-value

specifies a smoothing parameter value. If you do not specify a value, the value is determined automatically.

Restriction:

To use this option, all of the X and Y variables must be numeric.

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

specifies the appearance of the markers in the plot. 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 markers. 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.

SIZE= n

specifies the size of the markers in pixels.

Default:

For ungrouped data, the default marker size is specified by the MarkerSize attribute of the GraphDataDefault style element in the current style.

For grouped data, the default marker size is specified by the MarkerSize attribute of the GraphData1 ... GraphDatan style elements in the current style.

SYMBOL= symbol-name

specifies the symbol for the markers. See Marker Symbols for a list of valid marker symbols.

Default:

For ungrouped data, the default marker symbol is specified by the MarkerSymbol attribute of the GraphDataDefault style element in the current style.

For grouped data, the default marker symbol is specified by the MarkerSymbol attribute of the GraphData1 ... GraphDatan style elements in the current style.

NOLEGEND

removes the legend from the plot.

PBSPLINE <= (options)>

adds a fitted, penalized B-spline curve to the scatter plot.

options can be one or more of the following:

ALPHA= numeric-value

specifies the confidence level for the confidence limits. Specify a number between 0.00 (100% confidence) and 1.00 (0% confidence).

Note: This option has no effect if you do not specify either the CLI option or the CLM option. [cautionend]

Default:

.05

CLI

creates confidence limits for individual predicted values for each observation.

CLM

creates confidence limits for a mean predicted value for each observation.

DEGREE= n

specifies the degree of the spline transformation.

Default:

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

specifies the appearance of the curve 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 GraphFit 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 GraphFit 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 GraphFit 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.

Restriction:

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

NKNOTS= n

specifies the number of evenly spaced internal knots.

Default:

100

NOGROUP

specifies that the curve does not use the group variable from the scatter plot.

SMOOTH= numeric-value

specifies a smoothing parameter value. If you do not specify this option, then a smoothing value is determined automatically.

Restriction:

To use this option, all of the X and Y variables must be numeric.

REFTICKS

duplicates the tick marks from the X and Y axes on the opposite sides of the graph.

REG <= (options)>

adds a regression fit to the scatter plot.

options can be one or more of the following:

ALPHA= numeric-value

specifies the confidence level for the confidence limits. Specify a number between 0.00 (100% confidence) and 1.00 (0% confidence).

Note: This option has no effect if you do not specify either the CLI option or the CLM option. [cautionend]

Default:

.05

CLI

creates confidence limits for individual predicted values for each observation.

CLM

creates confidence limits for a mean predicted value for each observation.

DEGREE= n

specifies the degree of the polynomial fit. For example, 1 specifies a linear fit, 2 specifies a quadratic fit, and 3 specifies a cubic fit.

Default:

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

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 GraphFit 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 GraphFit 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 GraphFit 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.

Restriction:

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

NOGROUP

specifies that the fit does not use the group variable from the scatter plot.

Restriction:

To use this option, all of the X and Y variables must be numeric.

SPACING = n

specifies the amount of spacing (in pixels) that is placed between the cells in the graph.

Default:

TRANSPARENCY= numeric-value

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

Default:	0.0
Restriction:	This option is available with SAS 9.2 Phase 2 and later.

Top of Page