The SGSCATTER Procedure

PLOT Statement

Creates a paneled graph that contains multiple independent scatter plots.

Featured in:

Creating a Graph with Multiple Independent Scatter Plots and Spline Curves

Syntax

PLOT plot-request(s) </ options>;

options can be one or more of the following:

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

Required Arguments

plot-request-1 < ... plot-request-n>

specifies one or more plot requests. Each plot request specifies the variables to plot and produces a separate cell. All variables must be in the input data set. Multiple plot requests are separated with blanks. You can plot character or numeric variables. A plot request can be either of these:

y-variable*x-variable

plots the values of two variables.

y-variable: variable plotted on the left vertical axis.
x-variable: variable plotted on the horizontal axis.

(y-variable(s))*(x-variable(s))

plots the values of two or more variables and produces a separate cell for each combination of Y and X variables. That is, each Y*X pair is plotted on a separate set of axes.

y-variable(s): variables plotted on the left vertical axes.
x-variable(s): variables plotted on the horizontal axes.

If you use only one y-variable or only one x-variable, omit the parentheses for that variable, for example,

plot (temp rain)*month;

This plot request produces two cells, one for TEMP and MONTH and one for RAIN and MONTH.

Options

COLUMNS= n

specifies the number of columns in the graph.

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= n

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:

This suboption has no effect if you also specify the ACROSS= suboption.

LOCATION= CELL | OUTSIDE

specifies whether the legend is placed inside of the plot area (CELL) or outside of the plot area (OUTSIDE).

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, then a smoothing 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 graph.

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 option 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 each cell.

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.

ROWS= n

specifies the number of rows in the graph.

Interaction:

This option has no effect if you specify the COLUMNS= option.

SPACING = n

specifies the amount of spacing (in pixels) that is placed between the cells in the graph, if the PLOT statement creates multiple cells.

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.

UNISCALE= X | Y | ALL

specifies that the X axis, Y axis, or both axes are scaled uniformly for all of the cells in the graph. By default, no scaling is performed. If this option is used, then all variables on the specified axis must be of the same type (all numeric or all character).

Top of Page