SGPANEL Procedure
- Syntax
Procedure SyntaxPROC SGPANEL StatementPANELBY StatementBAND StatementBUBBLE StatementDENSITY StatementDOT StatementHBAR StatementHBARPARM StatementHBOX StatementHIGHLOW StatementHISTOGRAM StatementHLINE StatementKEYLEGEND StatementLINEPARM StatementLOESS StatementNEEDLE StatementPBSPLINE StatementREFLINE StatementREG StatementSCATTER StatementSERIES StatementSTEP StatementVBAR StatementVBARPARM StatementVBOX StatementVECTOR StatementVLINE StatementCOLAXIS StatementROWAXIS Statement - Overview
- Concepts
- Examples
LINEPARM Statement
Creates a straight line specified by a point and
a slope. You can generate a single line by specifying a constant for
each required argument. You can generate multiple lines by specifying
a numeric variable for any or all required arguments.
| Requirement: | The statement must be used with another plot statement that is derived from data values that provide boundaries for the axis area. For example, the LINEPARM statement can be used with a scatter plot or a histogram. |
| Example: | About Parameterized Lines |
Syntax
LINEPARM X= numeric-value |numeric-variable
Y= numeric-value |numeric-variable
SLOPE= numeric-value |numeric-variable
</option(s)>;
Summary of Optional Arguments
Group options
specifies that missing values of the group variable
are not included in the plot.
Label options
adds a label for the line.
specifies the appearance of the labels in the plot
when you use the CURVELABEL= option.
specifies the location of the curve label.
Line options
specifies that the data for the line is ignored
when determining the data ranges for the axes.
specifies the appearance of the line.
prevents the line from being extended beyond the
axis offset.
Plot options
specifies the value of the ID variable in an attribute
map data set.
specifies a variable that is used to group the data.
specifies a label that identifies the plot in the
legend.
specifies a name for the plot.
specifies the degree of transparency for the lines.
Required Arguments
- X= numeric-value | numeric-variable
-
specifies the X coordinate of a point.Notes:Values are in the units of the data.
If the value specified for the X= option is outside of the data range, then the data range is extended to include the specified point. This behavior can be changed with the CLIP= option.
If you specify a variable, and the variable contains any missing values, no line is drawn for the respective observation.
- Y= numeric-value | numeric-variable
-
specifies the Y coordinate of a point.Notes:Values are in the units of the data.
If the value specified for the Y= option is outside of the data range, then the data range is extended to include the specified point. This behavior can be changed with the CLIP= option.
If you specify a variable, and the variable contains any missing values, no line is drawn for the respective observation.
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.
- CLIP
- specifies that the data for the line is ignored when determining the data ranges for the axes. Each axis scale is determined by the other plots in the overlay. This might result in the line not being displayed if its data range is not within the data ranges of the other plots.
- CURVELABEL <=“text-string”>
- adds a label for the line. You can also specify the label text. If you do not specify a label, then SLOPE=value is used. If you specify a GROUP variable, the group value is shown instead of the slope.
- CURVELABELATTRS= style-element <(options)> | (options)
- specifies the appearance of the labels in the plot
when you use the CURVELABEL= 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.
- COLOR= color
-
specifies the color of the line 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 GraphValueText 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 GraphValueText style element in the current style.Restriction:You cannot specify a list of font family names.
- 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 GraphValueText style element in the current style.
- STYLE= ITALIC | NORMAL
-
specifies whether the label characters are italic or normal.Default:The default font style is specified by the FontStyle attribute of the GraphValueText style element in the current style.
- WEIGHT= BOLD | NORMAL
-
specifies whether the label characters are bold or normal.Default:The default font weight is specified by the FontWeight attribute of the GraphValueText style element in the current style.
Here is an example expression:CURVELABELATTRS=(Color=Green Family=Arial Size=8 Style=Italic Weight=Bold)
Default:The default style element is GraphValueText.Interaction:This option has no effect unless the CURVELABEL option is also specified.
- CURVELABELPOS= MAX | MIN
- specifies the location of the curve label. Specify one of the
following values:
Default:MAXInteraction:This option has no effect unless CURVELABEL is also specified.
- 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 plot in the
legend. By default, the label
“LineParm” is used (if you specify a numeric value for
Y) or the Y variable name is used (if you specify a variable for Y). Interaction:The LEGENDLABEL= option has no effect if you also specify the GROUP= option in the same plot statement.
- LINEATTRS= style-element <(options)> | (options)
- specifies the appearance of the 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.
For more information about style elements, see Style Elements for Use with ODS Graphics.
- 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: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. For a list of line patterns, see 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. For a list of measurement units that are supported, see Units of Measurement.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.
Default: GraphDataDefault is the default style element.
- 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.
- NOEXTEND
- prevents the line from being extended beyond the axis offset. When specified, there might be a gap between the line and the axis. The gap is controlled by the axis offset. If the offset is set to 0, then there is no gap.