The SGPANEL Procedure

HLINE Statement

Creates a horizontal line plot (the line is vertical). You can use the HLINE statement with the HBAR statement to create a horizontal bar-line chart.

Interaction:

The HLINE statement can be combined only with other categorization plot statements in the SGPANEL procedure. See Plot Content.

Syntax

HLINE category-variable < / option(s)>;

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

Line options:

	ALPHA= numeric-value
	BREAK
	CURVELABEL <= text-string>
	CURVELABELPOS= MIN \| MAX \|START \| END
	DATALABEL <= variable>
	FREQ= numeric-variable
	LIMITATTRS= style-element <(options)> \| (options)
	LIMITS= BOTH \| LOWER \| UPPER
	LIMITSTAT= CLM \| STDDEV \| STDERR
	LINEATTRS= style-element <(options)> \| (options)
	MARKERATTRS= style-element <(options)> \| (options)
	MARKERS
	MISSING
	NOSTATLABEL
	NUMSTD= n
	RESPONSE= response-variable
	STAT= FREQ \| MEAN \| SUM
	URL= character-variable
	WEIGHT= numeric-variable

Plot options:

GROUP= variable

LEGENDLABEL= "text-string"

NAME= "text-string"

TRANSPARENCY= numeric-value

Required Arguments

category-variable: specifies the variable that classifies the observations into distinct subsets.

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

Default:	.05
Interaction:	This option has no effect if you do not specify LIMITSTAT=CLM. If your plot is overlaid with other summary plots, then the first ALPHA value that you specify is used for all of the plots.

BREAK

creates a break in the line for each missing value for the category variable.

CURVELABEL <="text-string">

adds a label for the line. You can also specify the label text. If you do not specify a label, then the label from the response variable is used.

CURVELABELPOS= MIN | MAX | START | END

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

MIN: places the curve label at the minimum value for the response axis.
MAX: places the curve label at the maximum value for the response axis.
START: places the curve label at the first point on the curve.
END: places the curve label at the last point on the curve.

Default:

END

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.

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.

Interaction:

If your plot is overlaid with other categorization plots, then the first FREQ variable that you specified is used for all of the plots.

GROUP= variable

specifies a category variable to divide the values into groups. A separate plot is created for each unique value of the category variable.

Interaction:

If you specify more than one categorization plot statement, then all of the plots must specify the same GROUP variable. If you do not specify the same GROUP= option for all of the categorization plots, then the GROUP= option has no effect.

LEGENDLABEL= "text-string"

specifies the label that identifies the line plot in the legend. By default, the label of the response variable is used. If there is no response variable label, then the name of the response variable and the computed statistic (SUM or MEAN) are used. If you do not specify a response variable, then the legend label is "Frequency".

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

LIMITS= BOTH | LOWER | UPPER

adds limit lines to the plot. Specify one of the following values:

BOTH: adds lower and upper limit lines to the plot.
LOWER: adds lower limit lines to the plot.
UPPER: adds upper limit lines to the plot.

By default, no limit lines are displayed. However, if you specify the LIMITSTAT= option, then the default is BOTH.

Note: Limit lines are displayed only when you specify STAT= MEAN. [cautionend]

LIMITSTAT= CLM | STDDEV | STDERR

specifies the statistic for the limit lines. Specify one of the following

CLM: confidence limits
STDDEV: standard deviation
STDERR: standard error

Default:	CLM
Interaction:	If you specify the LIMITSTAT= option, then the default value for the LIMITS= option is BOTH.

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

specifies the appearance of the lines in the line 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:

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.

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

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

specifies the appearance of the markers in the plot. This option has no effect unless you also specify the MARKERS 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 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.

MARKERS

adds data point markers to the plot.

MISSING

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

NAME= "text-string"

specifies a name for the plot. You can use the name to refer to this plot in other statements.

NOSTATLABEL

removes the statistic name from the axis and legend labels.

Restriction:

This option is available with SAS 9.2 Phase 2 and later.

NUMSTD= n

specifies the number of standard units for the limit lines, when you specify LIMITSTAT= STDDEV or LIMITSTAT= STDERR. You can specify any positive number, including decimals.

Default:

RESPONSE= response-variable

specifies a numeric response variable for the plot. The summarized values of the response variable are displayed on the horizontal axis.

STAT= FREQ | MEAN | SUM

specifies the statistic for the horizontal axis. Specify one of the following:

FREQ: the frequencies for the category variable. This is the default value when you do not specify the RESPONSE= option.
MEAN: the mean of the response variable.
SUM: the sum of the response variable. This is the default value when you specify the RESPONSE= option.

If you do not specify the RESPONSE= option, then only the FREQ statistic can be used. If you specify the RESPONSE= option, then you can use either the SUM or MEAN statistics.

TRANSPARENCY= numeric-value

specifies the degree of transparency for the lines and markers. 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.

WEIGHT= numeric-variable

specifies that each observation is weighted by a factor of w for computational purposes, where w is the value of the numeric variable. w can be any numeric value. If w is 0, negative or missing, then that observation is excluded from the analysis.

Interaction:

If your plot is overlaid with other categorization plots, then the first WEIGHT variable that you specified is used for all of the plots.

Top of Page

	GROUP= variable
	LEGENDLABEL= "text-string"
	NAME= "text-string"
	TRANSPARENCY= numeric-value