Dictionary of Common Options
Previous Page|Next Page

Dictionary of Common Options: CAPABILITY Procedure

This chapter provides detailed descriptions of options that you can specify in the following chart statements:

  • CDFPLOT

  • COMPHISTOGRAM

  • HISTOGRAM

  • PPPLOT

  • PROBPLOT

  • QQPLOT

The notes Traditional Graphics, ODS Graphics, and Line Printer identify options that apply to traditional graphics, ODS Graphics output, and line printer charts, respectively. As noted, some options are applicable only to comparative plots produced by the COMPHISTOGRAM statement or by another plot statement in conjunction with a CLASS statement.

ALPHADELTA=value

specifies the change in successive estimates of $\hat{\alpha }$ at which iteration terminates in the Newton-Raphson approximation of the maximum likelihood estimate of $\alpha $ for gamma distributions requested with the GAMMA option. Enclose the ALPHADELTA= option in parentheses after the GAMMA keyword. Iteration continues until the change in $\alpha $ is less than the value specified or the number of iterations exceeds the value of the MAXITER= option. The default value is 0.00001.

ALPHAINITIAL=value

specifies the initial value for $\hat{\alpha }$ in the Newton-Raphson approximation of the maximum likelihood estimate of $\alpha $ for gamma distributions requested with the GAMMA option. Enclose the ALPHAINITIAL= option in parentheses after the GAMMA keyword. The default value is Thom’s approximation of the estimate of $\alpha $. See Johnson, Kotz, and Balakrishnan (1995).

ANNOKEY

Traditional Graphicsapplies the annotation requested with the ANNOTATE= option only to the key cell of a comparative plot. By default, the procedure applies annotation to all of the cells. You can use the KEYLEVEL= option in the CLASS statement or the CLASSKEY= option in the COMPHISTOGRAM statement to specify the key cell.

ANNOTATE=SAS-data-set
ANNO=SAS-data-set

Traditional Graphicsspecifies an input data set that contains annotate variables, as described in SAS/GRAPH: Reference, for annotating traditional graphics. The ANNOTATE= data set you specify in the plot statement is used for all plots created by the statement. You can also specify an ANNOTATE= data set in the PROC CAPABILITY statement to enhance all plots created by the procedure (see ANNOTATE= Data Sets).

CAXIS=color
CAXES=color
CA=color

Traditional Graphicsspecifies the color for the axes and tick marks. This option overrides any COLOR= specifications in an AXIS statement.

CDELTA=value

specifies the change in successive estimates of c at which iterations terminate in the Newton-Raphson approximation of the maximum likelihood estimate of c for Weibull distributions requested by the WEIBULL option. Enclose the CDELTA= option in parentheses after the WEIBULL keyword. Iteration continues until the change in c between consecutive steps is less than the value specified or until the number of iterations exceeds the value of the MAXITER= option. The default value is 0.00001.

CFRAME=color

Traditional Graphicsspecifies the color for the area that is enclosed by the axes and frame.

CFRAMESIDE=color

Traditional Graphicsspecifies the color to fill the frame area for the row labels that display along the left side of a comparative plot. This color also fills the frame area for the label of the corresponding CLASS variable, if you associate a label with the variable.

CFRAMETOP=color

Traditional Graphicsspecifies the color to fill the frame area for the column labels that display across the top of a comparative plot. This color also fills the frame area for the label of the corresponding CLASS variable, if you associate a label with the variable.

CHREF=color | (color-list)
CH=color | (color-list)

Traditional Graphicsspecifies the colors for horizontal axis reference lines requested by the HREF= option. If you specify a single color, it is used for all HREF= lines. Otherwise, if there are fewer colors specified than reference lines requested, the remaining lines are displayed with the default reference line color. You can also specify the value _default in the color list to request the default color.

CINITIAL=value

specifies the initial value for $\hat{c}$ in the Newton-Raphson approximation of the maximum likelihood estimate of c for Weibull distributions requested with the WEIBULL or WEIBULL2 option. The default value is 1.8. See Johnson, Kotz, and Balakrishnan (1995).

COLOR=color
COLOR=color-list

Traditional Graphicsspecifies the color of the curve or reference line associated with a distribution or kernel density estimate. Enclose the COLOR= option in parentheses after a distribution option or the KERNEL option. In a HISTOGRAM statement, you can specify a list of colors in parentheses for multiple density curves.

CONTENTS='string'

specifies the table of contents grouping entry for output produced by the plot statement. You can specify CONTENTS='' to suppress the grouping entry.

CPROP=color | EMPTY
CPROP

Traditional Graphicsspecifies the color for a horizontal bar whose length (relative to the width of the tile) indicates the proportion of the total frequency that is represented by the corresponding cell in a comparative plot. By default, no proportion bars are displayed. You can specify the keyword EMPTY to display empty bars.

For traditional graphics with the GSTYLE system option in effect, you can specify CPROP with no argument to produce proportion bars using an appropriate color from the ODS style. The CPROP option is not available with ODS Graphics.

CSTATREF=color | (color-list)

Traditional Graphicsspecifies the colors for reference lines requested by the STATREF= option. If you specify a single color, it is used for all STATREF= lines. Otherwise, if there are fewer colors specified than reference lines requested, the remaining lines are displayed with the default reference line color. You can also specify the value _default in the color list to request the default color.

CTEXT=color
CT=color

Traditional Graphicsspecifies the color for tick mark values and axis labels.

CTEXTSIDE=color

Traditional Graphicsspecifies the color for the row labels that display along the left side of a comparative plot. If you do not specify the CTEXTSIDE= option, the color specified with the CTEXT= option is used. You can specify the CFRAMESIDE= option to change the background color for the row labels.

CTEXTTOP=color

Traditional Graphicsspecifies the color for the column labels that display along the left side of a comparative plot. If you do not specify the CTEXTTOP= option, the color specified with the CTEXT= option is used. You can use the CFRAMETOP= option to change the background color for the column labels.

CVREF=color | (color-list)
CV=color | (color-list)

Traditional Graphicsspecifies the colors for lines requested with the VREF= option. If you specify a single color, it is used for all VREF= lines. Otherwise, if there are fewer colors specified than reference lines requested, the remaining lines are displayed with the default reference line color. You can also specify the value _default in the color list to request the default color.

DESCRIPTION='string'
DES='string'

Traditional Graphicsspecifies a description, up to 256 characters long, for the GRSEG catalog entry for a traditional graphics chart. The default value is the analysis variable name.

FITINTERVAL=value

specifies the value of z for the method of percentiles when this method is used to fit a Johnson $S_ B$ or Johnson $S_ U$ distribution. The FITINTERVAL= option is specified in parentheses after the SB or SU option. The default of z is 0.524.

FITMETHOD=PERCENTILE | MLE | MOMENTS

specifies the method used to estimate the parameters of a Johnson $S_ B$ or Johnson $S_ U$ distribution. The FITMETHOD= option is specified in parentheses after the SB or SU option. By default, the method of percentiles is used.

FITTOLERANCE=value

specifies the tolerance value for the ratio criterion when the method of percentiles is used to fit a Johnson $S_ B$ or Johnson $S_ U$ distribution. The FITTOLERANCE= option is specified in parentheses after the SB or SU option. The default value is 0.01.

FONT=font

Traditional Graphicsspecifies a font for reference line and axis labels. You can also specify fonts for axis labels in an AXIS statement. The FONT= option takes precedence over the FTEXT= font specified in the GOPTIONS statement. For a list of software fonts, see SAS/GRAPH: Reference.

HAXIS=value

specifies the name of an AXIS statement describing the horizontal axis.

HEIGHT=value

Traditional Graphicsspecifies the height, in percentage screen units, of text for axis labels, tick mark labels, and legends. This option takes precedence over the HTEXT= option in the GOPTIONS statement.

HMINOR=n
HM=n

Traditional Graphicsspecifies the number of minor tick marks between each major tick mark on the horizontal axis. Minor tick marks are not labeled. By default, HMINOR=0.

HREF=values

draws reference lines that are perpendicular to the horizontal axis at the values that you specify. Also see the CHREF= and LHREF= options.

HREFCHAR='character'

Line Printerspecifies the character used to form the lines requested by the HREF= option for a line printer chart. The default is the vertical bar (|).

HREFLABELS='label1' …'labeln'
HREFLABEL='label1' …'labeln'
HREFLAB='label1' …'labeln'

specifies labels for the lines requested by the HREF= option. The number of labels must equal the number of lines. Enclose each label in quotes. Labels can have up to 16 characters.

HREFLABPOS=n

Traditional GraphicsODS Graphicsspecifies the vertical position of HREFLABELS= labels, as described in the following table.

n

Position

1

along top of plot

2

staggered from top to bottom of plot

3

along bottom of plot

4

staggered from bottom to top of plot

By default, HREFLABPOS=1. Note: HREFLABPOS=2 and HREFLABPOS=4 are not supported for ODS Graphics output.

INFONT=font

Traditional Graphicsspecifies a font to use for text inside the framed areas of the plot. The INFONT= option takes precedence over the FTEXT= option in the GOPTIONS statement. For a list of software fonts, see SAS/GRAPH: Reference.

INHEIGHT=value

Traditional Graphicsspecifies the height, in percentage screen units, of text used inside the framed areas of the plot. If you do not specify the INHEIGHT= option, the height specified with the HEIGHT= option is used.

INTERTILE=value

Traditional Graphicsspecifies the distance in horizontal percentage screen units between the framed areas, called tiles, of a comparative plot. By default, INTERTILE=0.75 percentage screen units. You can specify INTERTILE=0 to create contiguous tiles.

L=linetype
L=linetype-list

Traditional Graphicsspecifies the line type of the curve or reference line associated with a distribution or kernel density estimate. Enclose the L= option in parentheses after the distribution option or the KERNEL option. In a HISTOGRAM statement, you can specify a list of line types in parentheses for multiple density curves.

LHREF=linetype | linetype-list
LH=linetype | linetype-list

Traditional Graphicsspecifies the line types for the reference lines that you request with the HREF= option. If you specify a single line type, it is used for all HREF= lines. Otherwise, if there are fewer line types specified than reference lines requested, the remaining lines are displayed with the default reference line type. You can also specify line type 0 to request the default color.

LSTATREF=linetype | linetype-list

Traditional Graphicsspecifies the line types for the reference lines that you request with the STATREF= option. If you specify a single line type, it is used for all STATREF= lines. Otherwise, if there are fewer line types specified than reference lines requested, the remaining lines are displayed with the default reference line type. You can also specify line type 0 to request the default color.

LVREF=linetype | linetype-list
LV=linetype | linetype-list

Traditional Graphicsspecifies the line types for lines requested with the VREF= option. If you specify a single line type, it is used for all VREF= lines. Otherwise, if there are fewer line types specified than reference lines requested, the remaining lines are displayed with the default reference line type. You can also specify line type 0 to request the default color.

MAXITER=n

specifies the maximum number of iterations in the Newton-Raphson approximation of the maximum likelihood estimate of $\alpha $ for gamma distributions requested with the GAMMA option and c for Weibull distributions requested with the WEIBULL and WEIBULL2 options. Enclose the MAXITER= option in parentheses after the GAMMA, WEIBULL, or WEIBULL2 keywords. The default value of n is 20.

NAME='string'

Traditional Graphicsspecifies the name of the GRSEG catalog entry for a traditional graphics plot, and the name of the graphics output file if one is created. The name can be up to 256 characters long, but the GRSEG name is truncated to eight characters. The default value is 'CAPABILI'.

NCOLS=n
NCOL=n

Traditional GraphicsODS Graphicsspecifies the number of columns per panel in a comparative plot. By default, NCOLS=1 if you specify only one CLASS variable, and NCOLS=2 if you specify two CLASS variables. If you specify two CLASS variables, you can use the NCOLS= option with the NROWS= option.

NOFRAME

Traditional Graphicssuppresses the frame around the subplot area.

NOHLABEL

Traditional GraphicsODS Graphicssuppresses the label for the horizontal axis. You can use this option to reduce clutter.

NOVLABEL

Traditional GraphicsODS Graphicssuppresses the label for the vertical axis. You can use this option to reduce clutter.

NOVTICK

Traditional GraphicsODS Graphicssuppresses the tick marks and tick mark labels for the vertical axis. This option also suppresses the label for the vertical axis.

NROWS=n
NROW=n

Traditional GraphicsODS Graphicsspecifies the number of rows per panel in a comparative plot. By default, NROWS=2. If you specify two CLASS variables, you can use the NCOLS= option with the NROWS= option.

ODSFOOTNOTE=FOOTNOTE | FOOTNOTE1 | 'string'

ODS Graphicsadds a footnote to ODS Graphics output. If you specify the FOOTNOTE (or FOOTNOTE1) keyword, the value of SAS FOOTNOTE statement is used as the graph footnote. If you specify a quoted string, that is used as the footnote. The quoted string can contain either of the following escaped characters, which are replaced with the appropriate values from the analysis:

$\backslash $n

analysis variable name

$\backslash $l

analysis variable label (or name if the analysis variable has no label)

ODSFOOTNOTE2=FOOTNOTE2 | 'string'

ODS Graphicsadds a secondary footnote to ODS Graphics output. If you specify the FOOTNOTE2 keyword, the value of SAS FOOTNOTE2 statement is used as the secondary graph footnote. If you specify a quoted string, that is used as the secondary footnote. The quoted string can contain any of the following escaped characters, which are replaced with the appropriate values from the analysis:

$\backslash $n

analysis variable name

$\backslash $l

analysis variable label (or name if the analysis variable has no label)

ODSTITLE=TITLE | TITLE1 | NONE | DEFAULT | LABELFMT | 'string'

ODS Graphicsspecifies a title for ODS Graphics output.

TITLE (or TITLE1)

uses the value of SAS TITLE statement as the graph title.

NONE

suppresses all titles from the graph.

DEFAULT

uses the default ODS Graphics title (a descriptive title consisting of the plot type and the analysis variable name.)

LABELFMT

uses the default ODS Graphics title with the variable label instead of the variable name.

If you specify a quoted string, that is used as the graph title. The quoted string can contain the following escaped characters, which are replaced with the appropriate values from the analysis:

$\backslash $n

analysis variable name

$\backslash $l

analysis variable label (or name if the analysis variable has no label)

ODSTITLE2=TITLE2 | 'string'

ODS Graphicsspecifies a secondary title for ODS Graphics output. If you specify the TITLE2 keyword, the value of SAS TITLE2 statement is used as the secondary graph title. If you specify a quoted string, that is used as the secondary title. The quoted string can contain the following escaped characters, which are replaced with the appropriate values from the analysis:

$\backslash $n

analysis variable name

$\backslash $l

analysis variable label (or name if the analysis variable has no label)

OVERLAY

ODS Graphicsspecifies that plots associated with different levels of a CLASS variable be overlaid onto a single plot, rather than displayed as separate cells in a comparative plot. If you specify the OVERLAY option with one CLASS variable, the output associated with each level of the CLASS variable is overlaid on a single plot. If you specify the OVERLAY option with two CLASS variables, a comparative plot based on the first CLASS variable’s levels is produced. Each cell in this comparative plot contains overlaid output associated with the levels of the second CLASS variable.

The OVERLAY option applies only to ODS Graphics output. It is not available in the COMPHISTOGRAM and HISTOGRAM statements.

SCALE=value

is an alias for the SIGMA= option for distributions requested by the BETA, EXPONENTIAL, GAMMA, SB, SU, WEIBULL, and WEIBULL2 options and for the ZETA= option for distributions requested by the LOGNORMAL option.

SHAPE=value

is an alias for the ALPHA= option for distributions requested by the GAMMA option, for the SIGMA= option for distributions requested by the LOGNORMAL option, and for the C= option for distributions requested by the WEIBULL and WEIBULL2 options.

STATREF=keyword-list

Traditional GraphicsODS Graphicsdraws reference lines at the values of the statistics requested in the keyword-list. These reference lines are perpendicular to the horizontal axis in a histogram or cdf plot, and perpendicular to the vertical axis in a probability or Q-Q plot (unless the ROTATE option is specified). The STATREF= option does not apply to the PPPLOT statement.

Valid keywords are listed in the following table.

Keyword

Statistic

MAX

largest value

MEAN

sample mean

MEDIAN | Q2

median (50th percentile)

MIN

smallest value

MODE

most frequent value

P pctl

pctlth percentile

Q1

lower quartile (25th percentile)

Q3

upper quartile (75th percentile)

factor STD

factor standard deviations from the mean

Note that the factor specified with the STD keyword can be positive (which puts a reference line above the mean) or negative (below the mean).

Also see the CSTATREF=, LSTATREF=, STATREFLABELS=, and STATREFSUBCHAR= options.

STATREFLABELS='label1' …'labeln'
STATREFLABEL='label1' …'labeln'
STATREFLAB='label1' …'labeln'

specifies labels for the lines requested by the STATREF= option. The number of labels must equal the number of lines. Enclose each label in quotes. Labels can have up to 16 characters.

STATREFSUBCHAR='keyword-list'

Traditional GraphicsODS Graphicsspecifies a substitution character (such as #) for labels specified with the STATREFLABELS= option. When the labels are displayed on a graph, the first occurrence of the specified character in each label is replaced with the value of the corresponding STATREF= statistic.

TURNVLABELS
TURNVLABEL

Traditional Graphicsturns the characters in the vertical axis labels so that they display vertically.

VAXIS=name
VAXIS=value-list

specifies the name of an AXIS statement describing the vertical axis. In a COMPHISTOGRAM or HISTOGRAM statement, you can alternatively specify a value-list for the vertical axis.

VAXISLABEL='label'

Traditional Graphicsspecifies a label for the vertical axis. Labels can have up to 40 characters.

VMINOR=n
VM=n

Traditional Graphicsspecifies the number of minor tick marks between each major tick mark on the vertical axis. Minor tick marks are not labeled. The default is zero.

VREF=value-list

draws reference lines perpendicular to the vertical axis at the values specified. Also see the CVREF= and LVREF= options.

VREFCHAR='character'

Line Printerspecifies the character used to form the lines requested by the VREF= option for a line printer chart. The default is the hyphen (-).

VREFLABELS='label1'…'labeln'
VREFLABEL='label1'…'labeln'
VREFLAB='label1'…'labeln'

specifies labels for the lines requested by the VREF= option. The number of labels must equal the number of lines. Enclose each label in quotes. Labels can have up to 16 characters.

VREFLABPOS=n

Traditional GraphicsODS Graphicsspecifies the horizontal position of VREFLABELS= labels. If you specify VREFLABPOS=1, the labels are positioned at the left of the plot. If you specify VREFLABPOS=2, the labels are positioned at the right of the plot. By default, VREFLABPOS=1 for traditional graphics and 2 for ODS Graphics.

W=value
W=value-list

Traditional Graphicsspecifies the width in pixels of the curve or reference line associated with a distribution or kernel density estimate. Enclose the W= option in parentheses after the distribution option or the KERNEL option. In a HISTOGRAM statement, you can specify a list of widths in parentheses for multiple density curves.

WAXIS=n

Traditional Graphicsspecifies the line thickness, in pixels, for the axes and frame.

Previous Page|Next Page|Top of Page
Copyright © SAS Institute Inc. All Rights Reserved.