Previous Page | Next Page

The SGPLOT Procedure

SCATTER Statement

Creates a scatter plot.
Featured in: Grouping a Scatter Plot, Adding a Prediction Ellipse to a Scatter Plot, Creating Lines and Bands from Pre-Computed Data

Syntax

SCATTER X= variable Y= variable < / option(s)>;

option(s) can be one or more options from the following categories:

Required Arguments

X= variable

specifies the variable for the x axis.

Y= variable

specifies the variable for the y axis.

Options

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.

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

specifies the appearance of the error bars 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 line. For more information about specifying colors, see SAS/GRAPH Colors and Images in the SAS/GRAPH: Reference, Second Edition.

Default: The default color is specified by the ContrastColor attribute of the GraphError style element 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: The default line pattern is specified by the LineStyle attribute of the GraphError style element 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: The default line thickness is specified by the LineThickness attribute of the GraphError style element in the current style.
Restriction: This option is available with SAS 9.2 Phase 2 and later.
FREQ= numeric-variable

specifies that each observation is repeated n times for computational purposes, where n is the value of the numeric variable. If n is not an integer, then it is truncated to an integer. If n is less than 1 or missing, then it is excluded from the analysis.

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 markers from the plot in the legend. By default, the label of the Y variable or the group value for each marker is used.

Interaction: The LEGENDLABEL= option has no effect if you also specify the GROUP= option in the same plot statement.
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 <units >

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

Default: The default marker size is specified by the MarkerSize attribute of the GraphDataDefault style element 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.
MARKERCHAR= variable

specifies a variable whose values replace the marker symbols in the plot. If a format is associated with the variable, then the formatted values are used as the marker symbols. If there is not a format associated with the variable and the variable contains numeric data, then the BEST6. format is used.

Note:   The MARKERCHAR= option overrides the DATALABEL= option and the SYMBOL= suboption of the MARKERS= option.  [cautionend]

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

specifies the appearance of the markers in the plot when you use the MARKERCHAR= option. 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 marker characters. 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 GraphDataText 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.
FAMILY= "font-family"

specifies the font family for the marker characters.

Default: The default font family is specified by the FontFamily attribute of the GraphDataText style element in the current style.
SIZE= n < units >

specifies the font size of the marker characters. You can also specify the unit of measurement. The default unit is pixels. See Units of Measurement for a list of the measurement units that are supported.

Default: The default font size is specified by the FontSize attribute of the GraphDataText style element in the current style.
STYLE= ITALIC | NORMAL

specifies whether the marker characters are italic (ITALIC) or normal (NORMAL).

Default: The default font style is specified by the FontStyle attribute of the GraphDataText style element in the current style.
WEIGHT= BOLD | NORMAL

specifies whether the marker characters are bold (BOLD) or normal (NORMAL).

Default: The default font weight is specified by the FontWeight attribute of the GraphDataText style element 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.

NOMISSINGGROUP

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

Restriction: This option is available with SAS 9.2 Phase 2 and later.
TRANSPARENCY= numeric-value

specifies the degree of transparency for the markers and error bars. Specify a value from 0.0 (completely opaque) to 1.0 (completely transparent).

Default: 0.0
URL= character-variable

specifies a character variable that contains URLs for web pages to be displayed when parts of the plot are selected within an HTML page.

Interaction: This option affects graphics output that is created through the ODS HTML destination only.

This option has no effect unless you also specify IMAGEMAP in the ODS GRAPHICS statement.
Default: By default, no HTML links are created.
X2AXIS

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

XERRORLOWER= numeric-variable

specifies a variable that contains the lower endpoints for the X error bars.

XERRORUPPER= numeric-variable

specifies a variable that contains the upper endpoints for the X error bars.

Y2AXIS

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

YERRORLOWER= numeric-variable

specifies a variable that contains the lower endpoints for the Y error bars.

YERRORUPPER= numeric-variable

specifies a variable that contains the upper endpoints for the Y error bars.

Previous Page | Next Page | Top of Page

Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.