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 $\text{[math]}$ at which iteration terminates in the Newton-Raphson approximation of the maximum likelihood estimate of $\text{[math]}$ for gamma distributions requested with the GAMMA option. Enclose the ALPHADELTA= option in parentheses after the GAMMA keyword. Iteration continues until the change in $\text{[math]}$ 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 $\text{[math]}$ in the Newton-Raphson approximation of the maximum likelihood estimate of $\text{[math]}$ 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 $\text{[math]}$ . See Johnson, Kotz, and Balakrishnan (1995).

ANNOKEY

[Traditional Graphics]applies 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 Graphics]specifies 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 Graphics]specifies 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 $\text{[math]}$ at which iterations terminate in the Newton-Raphson approximation of the maximum likelihood estimate of $\text{[math]}$ for Weibull distributions requested by the WEIBULL option. Enclose the CDELTA= option in parentheses after the WEIBULL keyword. Iteration continues until the change in $\text{[math]}$ 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 Graphics]specifies the color for the area that is enclosed by the axes and frame.

CFRAMESIDE=color

[Traditional Graphics]specifies 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 Graphics]specifies 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

CH=color

[Traditional Graphics]specifies the color for horizontal axis reference lines requested by the HREF= option.

CINITIAL=value

specifies the initial value for $\text{[math]}$ in the Newton-Raphson approximation of the maximum likelihood estimate of $\text{[math]}$ 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 Graphics]specifies 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 Graphics]specifies 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.

CTEXT=color

CT=color

[Traditional Graphics]specifies the color for tick mark values and axis labels.

CTEXTSIDE=color

[Traditional Graphics]specifies 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 Graphics]specifies 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

CV=color

[Traditional Graphics]specifies the color for lines requested with the VREF= option.

DESCRIPTION='string'

DES='string'

[Traditional Graphics]specifies 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 $\text{[math]}$ for the method of percentiles when this method is used to fit a Johnson $\text{[math]}$ or Johnson $\text{[math]}$ distribution. The FITINTERVAL= option is specified in parentheses after the SB or SU option. The default of $\text{[math]}$ is 0.524.

FITMETHOD=PERCENTILE | MLE | MOMENTS

specifies the method used to estimate the parameters of a Johnson $\text{[math]}$ or Johnson $\text{[math]}$ 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 $\text{[math]}$ or Johnson $\text{[math]}$ distribution. The FITTOLERANCE= option is specified in parentheses after the SB or SU option. The default value is 0.01.

FONT=font

[Traditional Graphics]specifies 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 Graphics]specifies 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 Graphics]specifies 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 Printer]specifies 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 Graphics][ODS Graphics]specifies the vertical position of HREFLABELS= labels, as described in the following table.

$\text{[math]}$	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 Graphics]specifies 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 Graphics]specifies 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 Graphics]specifies 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 Graphics]specifies 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

LH=linetype

[Traditional Graphics]specifies the line type for the reference lines that you request with the HREF= option.

LVREF=linetype

LV=linetype

[Traditional Graphics]specifies the line type for lines requested with the VREF= option.

MAXITER=n

specifies the maximum number of iterations in the Newton-Raphson approximation of the maximum likelihood estimate of $\text{[math]}$ for gamma distributions requested with the GAMMA option and $\text{[math]}$ 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 $\text{[math]}$ is 20.

NAME='string'

[Traditional Graphics]specifies 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 Graphics][ODS Graphics]specifies 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

suppresses the frame around the subplot area.

NOHLABEL

[Traditional Graphics]suppresses the label for the horizontal axis. You can use this option to reduce clutter.

NOVLABEL

[Traditional Graphics]suppresses the label for the vertical axis. You can use this option to reduce clutter.

NOVTICK

suppresses 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 Graphics][ODS Graphics]specifies 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.

OVERLAY

[ODS Graphics]specifies 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.

TURNVLABELS

TURNVLABEL

[Traditional Graphics]turns 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 Graphics]specifies a label for the vertical axis. Labels can have up to 40 characters.

VMINOR=n

VM=n

[Traditional Graphics]specifies 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 Printer]specifies 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 Graphics][ODS Graphics]specifies 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 Graphics]specifies 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 Graphics]specifies the line thickness, in pixels, for the axes and frame.