VALUE Statement

VALUE Statement Summary

A VALUE statement within the DISCRETEATTRMAP block associates graphical properties to with a discrete value in the attribute map. To associate graphical properties with multiple values, specify multiple VALUE statements in the attribute map, using the following general syntax for each of the statements:

VALUE value-spec </option(s)>;

For a specific example, see the Example Program.

If the discrete attribute map is referenced by a plot statement in the template, the graphical properties that are defined in the VALUE statements are used in the plot. If a discrete legend is generated for the plot, the graphical properties are represented in that legend.

If a discrete attribute map is referenced directly in a DISCRETELEGEND statement, the graphical properties that are defined in the VALUE statement are mapped directly to the legend and are independent of the values in the data. For more information and an example, see the Statement Summary.

If two or more VALUE statements define attributes to associate with the same classification values, the last VALUE statement's settings are used.

By default when comparing a column's value to a string that is specified for the VALUE statement's value-spec,

the column value is formatted to a string, using the format that is defined for the column or the default format if no format has been define for the column
leading spaces are trimmed from the string that is specified in the VALUE statement
a case-sensitive comparison is performed between the column string and the VALUE string.

To change the default behavior for the comparison, you can use the DISCRETEATTRMAP statement’s TRIMLEADING= and IGNORECASE= options.

VALUE Statement Argument

value-spec

specifies one or more formatted strings or the keyword OTHER. Strings are always quoted. Multiple strings must be separated by blanks, and each of the strings must be enclosed in its own set of quotation marks. The formatted strings must be equal to the formatted values of the classification column that is used with the DISCRETEATTRVAR statement.

OTHER

Creates a category for all other column values that are not explicitly assigned with VALUE statements. This keyword is not quoted. The default attributes for these values are derived from the GraphOther style element.

Restriction: If a user-defined format is associated with the classification column, you should specify the same formatted strings that appear in the format definition.

The following examples elaborate on the value-spec strings:

"Hybrid"	By default, all string comparisons are case-sensitive. By default, the string Hybrid does not match the string HYBRID.
"HYBRID"	If IGNORECASE=TRUE in the DISCRETEATTRMAP statement, you can specify an upper-, lower-, or mixed-cased string for the value-spec string. When IGNORECASE=TRUE, the string Hybrid matches the string HYBRID.
"15JAN2011"	If a numeric column is being mapped with a VALUE statement, you must specify the formatted value of the column. This example shows how to specify the value of a numeric SAS date column that has a DATE9. format associated with it.
"."	If a numeric column has a missing value, you should use the formatted value for missing, which is "." by default. If the MISSING= system option is used to change the default string, you should match that value. For example, if OPTIONS MISSING="M" is specified in the SAS program, you should use "M" in the VALUE statement to represent missing values.
" "	If a character column has a missing value, you should use the formatted value for missing, which is " " by default.
"Truck" "SUV"	Multiple strings can be specified to indicate that each of the specified values matches to the same graphical properties. It does not mean that a single new category is formed. The list of strings is separated by blanks, and each string is enclosed in its own set of quotation marks.

VALUE Statement Options

FILLATTRS=style-element | style-element (fill-options) | (fill-options)

the fill attributes to use when an attribute map is applied to filled areas in a graph. See General Syntax for Attribute Options for the syntax on using a style-element and Fill Options for available fill-options.

Default:

If the attribute map is used in a plot, unspecified attributes receive the attributes that they would have if the attribute map were not defined.
If the attribute map is used directly in a legend, unspecified attributes derive attributes from the GraphDataDefault style element.

Restriction: This option does not support the TRANSPARENCY= setting in the specified fill attribute.

LINEATTRS=style-element | style-element (line-options) | (line-options)

specifies the line attributes to use when an attribute map is applied to lines in a graph. See General Syntax for Attribute Options for the syntax on using a style-element and Line Options for available line-options.

Default:

If the attribute map is used in a plot, unspecified attributes receive the attributes that they would have if the attribute map were not defined.
If the attribute map is used directly in a legend, unspecified attributes derive attributes from the GraphDataDefault style element.

Restriction: This option does not support the THICKNESS= setting in the specified line attribute.

MARKERATTRS=style-element | style-element (marker-options) | (marker-options)

specifies the marker attributes to use when an attribute map is applied to marker symbols in a graph. See General Syntax for Attribute Options for the syntax on using a style-element and Marker Options for available marker-options.

Default:

If the attribute map is used in a plot, unspecified attributes receive the attributes that they would have if the attribute map were not defined.
If the attribute map is used directly in a legend, unspecified attributes derive attributes from the GraphDataDefault style element.

Restriction: The SIZE=, TRANSPARENCY=, and WEIGHT= suboptions are ignored.