• support.sas.com

• Knowledge Base

• Support

• Training & Bookstore

• Community

SCATTERPLOTMATRIX Statement

Scatter Plot Matrix

column-list

specifies a list of columns to plot.

Requirement:

There must be at least three columns to produce a useful matrix.

BACKGROUND= color | style-reference

specifies the background color of the graph.

Default:

Specified by the GraphBackground:Background style reference.

BACKTRANSPARENCY= number

specifies the degree of the transparency of the background color.

Default:	0
Range:	0 (opaque) to 1 (entirely transparent)
Interaction:	The BACKTRANSPARENCY= option overrides the TRANSPARENCY= option for the background.
See also:	TRANSPARENCY= option

DATALABEL= column

specifies the labels of the markers.

Default:	No labels are displayed.
Tip:	The position of the labels are adjusted to prevent the labels from overlapping.

DATALABELCOLOR= color | style-reference

specifies the color of the marker labels.

Default:	Specified by the GraphDataDefault:ContrastColor style reference.
Interaction:	The DATALABELCOLOR= option overrides the GROUP= option.
Tip:	When the GROUP= option is used, each distinct group value is represented by a different color. The data label that is associated with the group is assigned the group color. The DATALABELCOLOR= option can be used to specify a single color for all data labels in a graph, without affecting items that have the group color, such as lines and marker symbols.

DATALABELFONTFAMILY= 'string' | style-reference

specifies the font family of the marker labels.

Default:	Specified by the GraphDataText:Font_Face style reference.
Restriction:	You must specify one font family name. You cannot specify a list of font family names.

DATALABELFONTSIZE= dimension | style-reference

specifies the font size of the marker labels.

Default:

Specified by the GraphDataText:Font_Size style reference.

DATALABELFONTSTYLE= NORMAL | ITALIC | style-reference

specifies the font style of the marker labels.

Default:

Specified by the GraphDataText:Font_Style style reference.

DATALABELFONTWEIGHT= NORMAL | BOLD | style-reference

specifies the font weight of the marker labels.

Default:

Specified by the GraphDataText:Font_Weight style reference.

DATALABELFORMAT= format

specifies the format of the marker labels.

Default:	The format of the column. For an unformatted numeric column, the data label uses the BEST12 format.
Restriction:	The w.d format must be specified using the Fw.d format.

DATATRANSPARENCY= number

specifies the degree of the transparency of the markers.

Default:	0
Range:	0 (opaque) to 1 (entirely transparent)
Interaction:	The DATATRANSPARENCY= option overrides the TRANSPARENCY= option for the markers.
See also:	TRANSPARENCY= option

DIAGONAL= (graph-list)

displays one or more of the following graphs in the diagonal cells of the plot matrix:

HISTOGRAM	specifies a histogram.
NORMAL	specifies a normal density curve.
KERNEL	specifies a kernel density estimate.

Default:	Variable labels are displayed in the diagonal cells.
Requirement:	When specifying multiple graphs, you must separate the values with a space. For example, the following specification requests both a histogram and a normal density curve in each diagonal cell: DIAGONAL=(HISTOGRAM NORMAL)
Interaction:	Ignored if the ROWVARS= option is used.
Interaction:	The GROUP= option is ignored when computing histograms, normal curves, and kernel density estimates.
Tip:	When the DIAGONAL= option is specified, the labels are drawn around the outside of the matrix, and the matrix axes are dropped.

GRIDTRANSPARENCY= number

specifies the degree of the transparency of the grid lines.

Default:	0
Range:	0 (opaque) to 1 (entirely transparent)
Interaction:	The GRIDTRANSPARENCY= option overrides the TRANSPARENCY= option for the grid lines.
See also:	TRANSPARENCY= option

GROUP= column

creates a separate scatter plot matrix for each unique group value of the specified column.

Default:	Each distinct group value is represented in the graph by a different combination of color and marker symbol.
Tip:	If error bars are displayed, then the bars are assigned the color and the line pattern of its group.
Tip:	The representations that are used to identify the groups can be overridden individually. For example, each distinct group value is represented by a different marker symbol, but the MARKERSYMBOL= option could be used to assign the same symbol to all of the plot's marker symbols.

INDEX= integer-column

specifies indices for remapping the assignment of the color and the marker symbols to group values.

Interaction:	The INDEX= option must be used with the GROUP= option. If the GROUP= option is not specified, the INDEX= option is ignored.
Restriction:	If the INDEX= option is not used, then the group values are mapped in the order of the data.
Main discussion:	Remapping the Color and Marker Symbols by Using the INDEX= option

MARKERCOLOR= color | style-reference | GRADIENT

specifies the colors of the observation markers.

Default:	Specified by the GraphDataDefault style element.
Restriction:	If the GRADIENT value is specified, then the MARKERCOLORGROUP= option must also be used. Colors are specified by the ThreeColorAltRamp style element.
Interaction:	The MARKERCOLOR= option overrides the GROUP= option and the marker symbol is used to distinguish the groups.

MARKERCOLORGROUP= numeric-column

specifies the column that is used to map marker colors.

Restriction:	The MARKERCOLORGROUP= option is ignored unless MARKERCOLOR=GRADIENT.
Tip:	The MARKERCOLORGROUP= option can be used to add a second response variable to an analysis. For example, in an analysis of weight by height, an age column might be specified by the MARKERCOLORGROUP= option so that the change in the gradient color of the markers reflects the change in age of the subjects in the study.

MARKERS= boolean

specifies whether observation markers are displayed.

Default:

TRUE

MARKERSIZE= dimension | style-reference

specifies the marker width. The marker width is equal to the marker height.

Default:

10px

MARKERSYMBOL= marker | CHARACTER

specifies the marker symbol of the observation markers.

The CHARACTER value specifies that the marker is composed of the leading characters of the values specified in the GROUP= option or in the MARKERSYMBOLGROUP= option.

Default:	Specified by the GraphDataDefault:MarkerSymbol style reference. If the GROUP= option is specified, then the markers are selected from the STANDARD marker set.
Requirement:	If the CHARACTER value is specified, then the MARKERSYMBOLGROUP= option must be specified.
Interaction:	If CHARACTER is specified for the MARKERSYMBOL= option , then the marker symbol is composed of all the characters from the values specified by the MARKERSYMBOLGROUP= option.
Interaction:	The MARKERSYMBOL= option overrides GROUP= option and the marker color is used to distinguish the groups.
Tip:	The data values are centered around the marker positions in both the X and Y directions. The positions are not adjusted to prevent overlap.

MARKERSYMBOLGROUP= column

specifies the column that is used to map the marker symbols.

Interaction:	The MARKERSYMBOLGROUP= option is ignored unless MARKERSYMBOL=CHARACTER.
Tip:	The MARKERSYMBOLGROUP= option is useful for specifying data values as the marker symbols in a graph.
See:	MARKERSYMBOL

NAME= 'string'

assigns a name to a plot statement for reference in other template statements.

Restriction:	The string specified by the NAME= option must be unique within the template.
Restriction:	The string specified by the NAME= option cannot contain embedded spaces.
Tip:	The NAME= option is used mostly in the DISCRETELEGEND statement in order to coordinate the use of colors, marker symbols, and line patterns between the graph and the legend.
Tip:	string is case sensitive.

ROWVARS = (column-list )

specifies a secondary list of columns to be paired with the required column list that is specified by the SCATTERPLOTMATRIX statement.

Interaction:	When the ROWVARS= option is specified, the DIAGONAL= option is ignored.
Tip:	The labels for the variables appear vertically on the left side of the matrix.

TIP= ( column-list )

specifies the information to display when the cursor is positioned over a graph element.

Default:	All of the variables specified for the graph.
Requirement:	You can activate tool tips in a SAS program by specifying an ODS GRAPHICS statement that has IMAGEFMT=STATICMAP specified.
Requirement:	Tool tips are only available for graphs that are written to the ODS HTML destination. Tool tips are only displayed if they are activated by the SAS program that generates the ODS graphics output.

TRANSPARENCY= number

specifies the degree of the transparency of the background, markers, grid, axis features, and wall, if displayed in a graph.

Default:	0
Range:	0 (opaque) to 1 (entirely transparent)
Interaction:	You can specify the transparency of individual graph elements by using the BACKTRANSPARENCY=, DATATRANSPARENCY=, GRIDTRANSPARENCY=, and WALLTRANSPARENCY= options. The value specified by the TRANSPARENCY= option is only applied to the transparencies that you do not specify individually.

WALLTRANSPARENCY= number

specifies the degree of the transparency of the plot wall.

Default:	0
Range:	0 (opaque) to 1 (entirely transparent)
Interaction:	The WALLTRANSPARENCY= option overrides the TRANSPARENCY= option for the graph wall.
See also:	TRANSPARENCY= option

XERRORLOWER= numeric-column

specifies the values for the lower endpoints on the X error bars.

Default:	The lower segment of the error bars is not drawn.
Restriction:	The error bar color cannot be changed.
Tip:	The values are actual values, not relative values.

XERRORUPPER= numeric-column

specifies the values for the upper endpoints on the X error bars.

Default:	The upper segment of the error bars is not drawn.
Restriction:	The error bar color cannot be changed.
Tip:	The values are actual values, not relative values.

XGRID= boolean

specifies whether the grid lines are drawn at the tick marks.

Default:	FALSE
Interaction:	Default characteristics for the grid lines are specified from the following attributes on the GraphGridLines style element: Color foreground Thickness linethicknes (default=1 px) Pattern linestyle (default=1)

XMAX= number

specifies the maximum X data value to use in the display of the data.

Default:	The maximum X value in the data.
Restriction:	If the data contains values greater than the number that is specified for the XMAX= option, then the values are excluded from the plot.
TIP:	The value specified by the XMAX= option is applied to all of the columns that are in the matrix. These values should be used with variables that have a similar scale.

XMIN= number

specifies the minimum X data value to use in the display of the data.

Default:	The minimum X value in the data.
Restriction:	If the data contains values that are less than the number specified for the XMIN= option, then the values are excluded from the plot.
TIP:	The value specified by the XMIN= option is applied to all of the columns that are in the matrix. These values should be used with variables that have a similar scale.

YERRORLOWER= numeric-column

specifies the values for the lower endpoints on the Y error bars.

Default:	The lower segment of the error bars is not drawn
Restriction:	The error bar color cannot be changed.
Tip:	The values are actual values, not relative values.

YERRORUPPER= numeric-column

specifies the values for the upper endpoints on the Y error bars.

Default:	The upper segment of the error bars is not drawn
Restriction:	The error bar color cannot be changed.
Tip:	The values are actual values, not relative values.

YGRID= boolean

specifies whether grid lines are drawn at the tick marks.

Default:	FALSE
Interaction:	Default characteristics for the grid lines are specified from the following attributes on the GraphGridLines style element: Color foreground Thickness linethickness (default=1 px) Pattern linestyle (default=1)

YMAX= number

specifies the maximum Y data value to use in the display of the data.

Default:	The maximum Y value in the data.
Restriction:	If the data contains values that are greater than the number specified for the YMAX= option, then the values are excluded from the plot.
TIP:	The value specified by the YMAX= option is applied to all of the columns that are in the matrix. These values should be used with variables that have a similar scale.

YMIN= number

specifies the minimum Y data value to use in the display of data.

Default:	The minimum Y value in the data.
Restriction:	If the data contains values that are less than the number specified for the YMIN= option, then the values are excluded from the plot.
TIP:	The value specified by the YMIN= option is applied to all of the columns that are in the matrix. These values should be used with variables that have a similar scale.

Specifying n number of columns with the SCATTERPLOTMATRIX statement and m number of columns with the ROWVARS= option produces an n columns by m rows matrix of scatter plots.

The following statements produces the 3 rows by 2 columns matrix shown in the figure below.

SCATTERPLOTMATRIX Height Weight
   / ROWVARS=(Age Height Weight); 

3 Rows by 2 Columns Matrix