SGPLOT Procedure

VBARPARM Statement

Creates a vertical bar chart based on a pre-summarized response value for each unique value of the category variable. You can also assign variables to the upper and lower limits.

Requirement:	The data must contain only one response value per unique category variable. If more than one value is found, a warning is written to the SAS log, and the graph might produce unpredictable results.
Interactions:	The HBARPARM statement can be combined only with other basic plot statements in the SGPLOT procedure. See Plot Type Compatibility. When used with particular styles, the VBARPARM statement produces fill patterns for grouped bars. For more information about fill patterns, see Using Fill Patterns to Distinguish Grouped Bar Charts.
Note:	An important distinction between VBARPARM and VBAR is that the response variable is required for VBARPARM. In addition, the response variable should contain pre-summarized computed values such as a sum or a mean.
Example:	About Bar Charts

Syntax

Required Arguments

Optional Arguments

Syntax

VBARPARM CATEGORY= category-variable RESPONSE= numeric-variable </ option(s)>;

Summary of Optional Arguments

Bar options

BARWIDTH= numeric-value

specifies the width of the bars as a ratio of the maximum possible width.

specifies a special effect to be used on all filled bars.

DISCRETEOFFSET= numeric-value

specifies an amount to offset all bars from the category midpoints.

FILL | NOFILL

specifies whether the bars are filled.

FILLATTRS= style-element | (COLOR= color)

specifies the appearance of the fill for the bars.

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

specifies the appearance of the limit lines in the plot.

LIMITLOWER= numeric-variable

specifies values for the lower endpoints on the limit lines.

LIMITUPPER= numeric-variable

specifies values for the upper endpoints on the limit lines.

MISSING

processes missing values as a valid category value and creates a bar for it.

OUTLINE | NOOUTLINE

specifies whether the bars have outlines.

Group options

CLUSTERWIDTH= numeric-value

specifies the cluster width as a ratio of the maximum width.

GROUP= variable

specifies a variable that is used to group the data.

GROUPORDER= ASCENDING | DESCENDING | DATA

specifies the ordering of bars within a group.

Label options

DATALABEL <= variable>

displays a label for each data point.

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

specifies the appearance of the labels in the plot when you use the DATALABEL= option.

DATALABELPOS= DATA | BOTTOM | TOP

specifies the location of the data label.

Plot options

ATTRID= variable

specifies the value of the ID variable in an attribute map data set.

LEGENDLABEL= “text-string”

specifies the label that identifies the bar chart in the legend.

NAME= “text-string”

specifies a name for the plot.

TRANSPARENCY= numeric-value

specifies the degree of transparency for the bars and limits, if displayed.

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.

Required Arguments

CATEGORY= category-variable: specifies the variable that categorizes the data. All values are treated as discrete values. The input data for this variable should contain unique values. When the category values are not unique, a warning is logged, and multiple bars are superimposed at the duplicated category values.

The CATEGORY axis is always discrete.

RESPONSE= numeric-variable: specifies a numeric response variable. The input data is expected to be pre-summarized computed values (sum, mean, and so on).

Optional Arguments

ATTRID= variable: specifies the value of the ID variable in an attribute map data set. You specify this option only if you are using an attribute map to control visual attributes of the graph. For more information, see Using SG Attribute Maps to Control Visual Attributes.

BARWIDTH= numeric-value: specifies the width of the bars as a ratio of the maximum possible width. The maximum width is equal to the distance between the center of each bar and the centers of the adjacent bars. Specify a value from 0.0 (narrowest) to 1.0 (widest).
For example, if you specify a width of 1, then there is no space between the bars. If you specify a width of .5, then the width of the bars is equal to the space between the bars.

Default:.8
1.0 when the GROUP option is specified and GROUPDISPLAY=CLUSTER

Interaction:When the GROUP option is specified, the bar width is determined by the maximum number of bars in any one group cluster. All bars are drawn with the same width, with the cluster being positioned symmetrically around the midpoint.

CLUSTERWIDTH= numeric-value: specifies the cluster width as a ratio of the maximum width. Specify a value from 0.0 (narrowest) to 1.0 (widest).
CLUSTERWIDTH is the fraction of the midpoint spacing used by all bars that are clustered around a midpoint (category value). The bar width is applied to the maximum bar spacing divided by the maximum number of bars in any one cluster.

Default:0.8

Interaction:This option is applicable only when the GROUP option is specified and when GROUPDISPLAY=CLUSTER.

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 calculated response are used for the data labels.

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

specifies the appearance of the labels in the plot when you use the DATALABEL= option. You can specify the appearance by using a style element or by using suboptions. If you specify a style element, you can also specify suboptions to override specific appearance attributes.

Here is an example that specifies a style element: DATALABELATTRS=GraphLabelText

options can be one or more of the following:

COLOR= color: specifies the color of the label characters. You can specify colors using the same color schemes that are supported by SAS/GRAPH software. For more information, see Color-Naming Schemes in SAS/GRAPH: Reference.

Default:For ungrouped data, the default color is specified by the Color 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 label characters. The SAS ODS styles use TrueType system fonts. For more information, see TrueType Fonts Supplied by SAS in SAS Language Reference: Concepts.

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 label characters. You can also specify the unit of measurement. The default unit is pixels. For a list of measurement units that are supported, see Units of Measurement.

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

Here is an example expression:

DATALABELATTRS=(Color=Green Family=Arial Size=8 Style=Italic Weight=Bold)

Default:The default style element is GraphDataText.

Interaction:This option has no effect unless the DATALABEL option is also specified.

DATALABELPOS= DATA | BOTTOM | TOP

specifies the location of the data label. Specify one of the following values:

DATA: places the label on the data primitives (at the upper boundary of the bars).

BOTTOM: places the label below the bars.

TOP: places the label above the bars.

Default:DATA

Interactions:This option displays limit information when limits are specified. When limits are specified, the default data label position is BOTTOM.

This option displays group values for each category when GROUP= is also specified.

This option displays response values for each overlaid chart.

This option has no effect unless you also specify the DATALABEL option.

specifies a special effect to be used on all filled bars. Specify one of the following (the samples were generated using the HTMLBlue style):

NONE
CRISP
GLOSS
MATTE
PRESSED
SHEEN

Default:NONE

Interactions:This option has no effect if the applied style uses a fill pattern and FILL is disabled for the style. If the style has both FILL and FILLPATTERN enabled, data skins will work. For more information about fill patterns, see Using Fill Patterns to Distinguish Grouped Bar Charts. For instructions about viewing the contents of style templates, see About Styles and Style Elements.

This option has no effect if you also specify NOFILL.

DISCRETEOFFSET= numeric-value: specifies an amount to offset all bars from the category midpoints. Specify a value from -0.5 (left offset) to +0.5 (right offset).

Default:0.0 (no offset)

FILL | NOFILL: specifies whether the bars are filled. The FILL option shows the fill color for the bars. The NOFILL option hides the fill color for the bars.

Default:FILL

Interactions:Specifying FILL also hides the outlines.

If NOFILL and NOOUTLINE are both specified, then both options are ignored.

FILLATTRS= style-element | (COLOR= color): specifies the appearance of the fill for the bars. You can specify the color of the fill by using a style element or by using the COLOR= suboption. You can specify colors using the same color schemes that are supported by SAS/GRAPH software. For more information, see Color-Naming Schemes in SAS/GRAPH: Reference.

Default:For ungrouped data, the default color is specified by the Color attribute of the GraphDataDefault style element in the current style. For grouped data, the default color is specified by the Color attribute of the GraphData1... GraphDatan style elements in the current style.

Interaction:This option has no effect if you specify the NOFILL option.

GROUP= variable: specifies a variable that is used to group the data. The plot elements for each group value are automatically distinguished by different visual attributes.

GROUPORDER= ASCENDING | DESCENDING | DATA

specifies the ordering of bars within a group.

ASCENDING: displays each group in ascending group value.

DESCENDING: displays each group in descending group value.

DATA: displays each group in data order of the group variable.

Interaction:This option is ignored unless GROUP= is specified.

LEGENDLABEL= “text-string”: specifies the label that identifies the bar chart in the legend. By default, the label of the RESPONSE= variable is used. If there is no response variable label, the name of the response variable is used.

Interaction:The LEGENDLABEL= option has no effect if you also specify the GROUP= option in the same plot statement.

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

specifies the appearance of the limit lines 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 also specify suboptions to override specific appearance attributes.

options can be one or more of the following:

COLOR= color: specifies the color of the line. You can specify colors using the same color schemes that are supported by SAS/GRAPH software. For more information, see Color-Naming Schemes in SAS/GRAPH: Reference.

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. For a list of line patterns, see 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. For a list of measurement units that are supported, see Units of Measurement.

Default:The default line thickness is specified by the LineThickness attribute of the GraphError style element in the current style.

LIMITLOWER= numeric-variable: specifies values for the lower endpoints on the limit lines. Limit lines are displayed as line segments with a serif at the end.

Default:The lower segments of the limit lines are not displayed. (Limit lines are displayed only if either LIMITLOWER= or LIMITUPPER= is specified.)

Interactions:If LIMITUPPER= is also specified, then the plot displays the lower and upper segments of the limit lines.

This option is ignored if GROUP= is specified and GROUPDISPLAY=STACK.

The appearance of the limit lines can be controlled by the LIMITATTRS= option.

LIMITUPPER= numeric-variable: specifies values for the upper endpoints on the limit lines. Limit lines are displayed as line segments with a serif at the end.

Default:The upper segments of the limit lines are not displayed. (Limit lines are displayed only if either LIMITLOWER= or LIMITUPPER= is specified.)

Interactions:If LIMITLOWER= is also specified, then the plot displays the lower and upper segments of the limit lines.

This option is ignored if GROUP= is specified and GROUPDISPLAY=STACK.

The appearance of the limit lines can be controlled by the LIMITATTRS= option.

MISSING: processes missing values as a valid category value and creates a bar for it.

NAME= “text-string”: specifies a name for the plot. You can use the name to refer to this plot in other statements.

Note:The name is case-sensitive. When you refer to the specified name in other statements, you must use the same exact capitalization.

OUTLINE | NOOUTLINE: specifies whether the bars have outlines. The OUTLINE option shows the outlines. The NOOUTLINE option hides the outlines.

Default:OUTLINE

Interactions:Specifying OUTLINE also hides the fill color.

If NOOUTLINE and NOFILL are both specified, then both options are ignored.

TRANSPARENCY= numeric-value: specifies the degree of transparency for the bars and limits, if displayed. 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.

Default:By default, no HTML links are created.

Interactions:This option affects graphics output that is created through the ODS HTML destination only. For more information about ODS destinations, see Specifying a Destination.

This option has no effect unless you also specify IMAGEMAP in the ODS GRAPHICS statement. For more information, see Using the ODS GRAPHICS Statement.