SGPLOT Procedure

REFLINE Statement

Creates a horizontal or vertical reference line.
About Reference Lines

Syntax

REFLINE variable | value-1 <... value-n> </ option(s)>;

Summary of Optional Arguments

Line options
specifies the axis that contains the reference line values.
specifies an amount to offset all lines from discrete X or Y values.
creates labels for each reference line.
specifies whether the labels are placed inside or outside of the plot area.
specifies the position of the labels.
specifies the appearance of the reference line.
extends the plot axes to contain the reference lines.
Plot options
specifies a label that identifies the markers from the plot in the legend.
specifies a name for the plot.
specifies the degree of transparency for the reference lines.

Required Arguments

variable
draws a reference line for each value of the specified variable.
value-1 <... value-n>
draws one or more reference lines at the values that you specify.

Optional Arguments

AXIS= X | X2 | Y | Y2
specifies the axis that contains the reference line values. For example, if you specify AXIS= X, vertical reference lines are drawn at points on the X axis.
Default:Y
DISCRETEOFFSET= numeric-value
specifies an amount to offset all lines from discrete X or Y values. Specify a value from -0.5 (left offset) to +0.5 (right offset).
Default:0.0 (no offset)
Requirement:This option is applicable only when the X or Y axis is discrete.
LABEL <= (“text-string-1” ... “text-string-n”)>
creates labels for each reference line. If you do not specify a label for a line, the reference value for that line is used as the label.
LABELLOC= INSIDE | OUTSIDE
specifies whether the labels are placed inside or outside of the plot area. The INSIDE option places the labels inside of the plot area. The OUTSIDE option places the labels outside of the plot area.
Default:OUTSIDE
LABELPOS= AUTO | MIN | MAX
specifies the position of the labels. MIN specifies the label is placed at the minimum value of the data axis. MAX specifies that the label is placed at the maximum value of the data axis. AUTO places the label automatically.
Default:AUTO
LEGENDLABEL= “text-string
specifies a label that identifies the markers from the plot in the legend. By default, the label “Reference Line” is used.
Interaction:This option has no effect unless you also specify the NAME= option.
LINEATTRS= style-element <(options)> | (options)
specifies the appearance of the reference line. 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 GraphReference 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 GraphReference 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 GraphReference 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.
Note:The name is case-sensitive. When you refer to the specified name in other statements, you must use the same exact capitalization.
NOCLIP
extends the plot axes to contain the reference lines. By default, if a reference line is created outside of the data range, then the reference line is not visible. This option has no effect if you do not create reference lines that are outside of the data range.
TRANSPARENCY= numeric-value
specifies the degree of transparency for the reference lines. Specify a value from 0.0 (completely opaque) to 1.0 (completely transparent).
Default:0.0