PROC RELIABILITY: RELATIONPLOT Statement

RELATIONPLOT Statement

<label:>RELATIONPLOT variable<*censor-variable(values)> <=group-variable>
</ options> ;

<label:>RELATIONPLOT (variable1 variable2) <=group-variable> </ options> ;

You use the RELATIONPLOT statement to create life-stress relation plots. A life-stress relation plot is a graphical tool for the analysis of data from accelerated life tests. The plot is a display of the relationship between life and stress, such as temperature or voltage. You can also use the RELATIONPLOT statement to display a probability plot alongside the relation plot. See Figure 14.9 for an example of a relation plot.

You can specify the keyword RPLOT as an alias for RELATIONPLOT. You can use any number of RELATIONPLOT statements after a PROC RELIABILITY statement. You can specify an optional label to distinguish between multiple RELATIONPLOT statements in the output.

See the section Analysis of Accelerated Life Test Data for an example that uses the RELATIONPLOT statement.

To create a life-stress relation plot, you must specify one variable. If your data are right censored, you must specify a censor-variable and, in parentheses, the values of the censor-variable that correspond to censored data values. You must specify one group-variable to represent the values of stress. The group-variable must be a numeric variable.

The RELATIONPLOT statement plots the uncensored values of your data given by variable versus the values of the group-variable. You can optionally display a boxplot of the values of the data. You can also plot percentiles of the distribution fitted to the data. The RELATIONPLOT statement produces the same tabular output as the PROBPLOT statement, and all the analysis options are the same as for the PROBPLOT statement.

The elements of the RELATIONPLOT statement are described as follows.

variable

represents the data for which a plot is to be produced. The variable must be a numeric variable in the input data set.

censor-variable(values)

indicates which observations in the input data set are right censored. You specify the values of censor-variable that represent censored observations by placing those values in parentheses after the variable name. If your data are not right censored, then you omit the specification of censor-variable; otherwise, censor-variable must be a numeric variable in the input data set.

(variable1 variable2)

is another method of specifying the data for which a life-stress plot is to be produced. You can use this syntax in a situation where uncensored, interval-censored, left-censored, and right-censored values occur in the same set of data. Table 14.27 shows how you use this syntax to specify different types of censoring by using combinations of missing and nonmissing values. See the section Lognormal Analysis with Arbitrary Censoring for an example that uses this syntax to create a probability plot.

group-variable

is a group variable. The group-variable must be a numeric variable in the input data set.

options

control the features of the relation plot. All options are specified after the slash (/) in the RELATIONPLOT statement. The "Summary of Options" section, which follows, lists all options by function.

The only type of relation plot currently available for interval data is the type in which percentiles of the fitted distribution are plotted at each stress level.

Summary of Options

Table 14.41 Analysis Options

Option

Option Description

CONFIDENCE=number

Specifies the confidence coefficient for all confidence intervals. The number must be between 0 and 1. The default value is 0.95.

CONVERGE=number

Specifies the convergence criterion for maximum likelihood fit. See the section Maximum Likelihood Estimation for details.

CONVH=number

Specifies the convergence criterion for the relative Hessian convergence criterion. See the section Maximum Likelihood Estimation for details.

CORRB

Requests the parameter correlation matrix.

COVB

Requests the parameter covariance matrix.

FITTYPE | FIT= fit-specification

Specifies the method of estimating distribution parameters. The available fit-specifications and their meanings are shown in the following table.

Fit Specification	Definition
LSYX	Least squares fit to the probability plot. The probability axis is the dependent variable.
LSXY	Least squares fit to the probability plot. The lifetime axis is the dependent variable.
MLE	Maximum likelihood (default).
MODEL	Use the fit from the preceding MODEL statement
NONE	No fit is computed.
REGRESSION<(variable=number-list)>	Use the fit from the preceding MODEL statement. Nonlinear relations and percentiles from models that use two independent variables can be plotted. variable is a second independent variable in the MODEL statement, and number-list is a list of values of the second independent variable for which to plot the percentiles as a function of the first independent variable.
WEIBAYES
<(CONFIDENCE \| CONF=number)>
	Weibayes fit. number is the confidence coefficient for the Weibayes fit and is between 0 and 1. The default is 0.95.

ITPRINT

Requests the iteration history for the maximum likelihood fit.

LRCL

Requests likelihood ratio confidence intervals for distribution parameters.

LRCLPER

Requests likelihood ratio confidence intervals for distribution percentiles.

LOCATION=number <LINIT>

Specifies a fixed or initial value of the location parameter.

MAXIT=number

Specifies the maximum number of iterations allowed for a maximum likelihood fit.

NOPCTILES

Suppresses computation of percentiles.

PCTLIST=number-list

Specifies a list of percentages for which to compute percentile estimates. The number-list must be a list of numbers separated by blanks or commas. Each number in the list must be between 0 and 100. If this option is not specified, percentiles are computed for a standard list of percentages.

PPOS=plotting-position

Specifies the plotting-position type used to compute nonparametric estimates of the probability distribution function. See the section Probability Plotting for details. The plotting position types available are shown in the following table.

Plotting Position	Type
EXPRANK	Expected ranks
MEDRANK	Median ranks
MEDRANK1	Median ranks (exact formula)
KM	Kaplan-Meier
MKM	Modified Kaplan-Meier (default)
NA \| NELSONAALEN	Nelson-Aalen

PPOUT

Requests a table of nonparametric cumulative probabilities in the printed output.

PSTABLE=number

Specifies a stable parameterization. The number must be between zero and one. See the section Stable Parameters for further information.

RELATION=transformation-keyword

Specifies the type of relationship between independent (stress) and dependent (lifetime) variables. The transformation specified is applied to the independent (stress) variable in the model. This determines the horizontal scale used in the relation plot. transformation-keyword can be any of the transformations listed in the following table. See Table 14.61 for definitions of the transformations.

Transformation Keyword	Type of Transformation
ARRHENIUS	Arrhenius (Nelson parameterization)
ARRHENIUS2	Arrhenius (activation energy)
POWER	Logarithmic
LINEAR	Linear
LOGISTIC	Logistic

READOUT

Specifies the data has the readout structure.

SCALE=number <SCINIT>

Specifies a fixed or initial value of scale parameter.

SHAPE=number <SHINIT>

Specifies a fixed or initial value of shape parameter.

SINGULAR=number

Specifies the singularity criterion for matrix inversion.

SURVTIME=number-list

Requests that survival function be computed for values in number-list. See the section Reliability Function for details.

THRESHOLD=number

Specifies a fixed threshold parameter. See Table 14.51 for the distributions with a threshold parameter.

variable=number-list

Enables creation of plots of percentiles from a regression model when two independent variables are used in a MODEL statement effect-list. The FIT=REGRESSION option must be used with this option. Percentile plots are created for each value of the independent variable in the number-list. number-list is a list of numeric values separated by blanks or commas, or in the form of a list $\text{[math]}$ to $\text{[math]}$ <by $\text{[math]}$ >.

Table 14.42 lists plot layout options that are available when you use traditional graphics.

Table 14.42 Plot Layout Options for Traditional Graphics

Option

Option Description

CENSYMBOL=symbol | (symbol-list)

Specifies symbols for censored values. The symbol is one of the symbol names (plus, star, square, diamond, triangle, hash, paw, point, dot, circle) or a letter (A–Z). If you are creating overlaid plots for groups of data, you can specify different symbols for the groups with a list of symbols or letters, separated by blanks, enclosed in parentheses. If no CENSYMBOL option is specified, the symbol used for censored values is the same as for failures.

HOFFSET=value

Specifies an offset for horizontal axis.

INBORDER

Requests a border around plots.

LBOXES=number

Specifies a line style for boxplots.

LFIT=linetype | (linetype-list))

Specifies line styles for fit lines and confidence curves in a probability plot. The linetype-list is a list of numbers from 1 to 46 representing different linetypes; the numbers can be separated by blanks or commas or can be a list in the form $\text{[math]}$ to $\text{[math]}$ <by $\text{[math]}$ >.

LPLOTFIT=linetype | (linetype-list))

Specifies line styles for percentile lines. linetype-list is a list of numbers that represent different linetypes; the numbers can be separated by blanks or commas or can be a list in the form $\text{[math]}$ to $\text{[math]}$ <by $\text{[math]}$ >.

NOCENPLOT

Suppresses plotting of censored data points.

NOCONF

Suppresses plotting of percentile confidence curves.

NOFIT

Suppresses plotting of fit line and percentile confidence curves.

NOFRAME

Suppresses the frame around the plotting area.

NOPPLEGEND

Suppresses the legend for overlaid probability plots.

NOPPOS

Suppresses plotting of symbols for failures in a probability plot.

NORPLEGEND

Suppresses the legend for the relation plot.

PINTERVALS=interval-type

Specifies the type of parametric pointwise confidence interval displayed in a probability plot. The available types of intervals are listed in the following table. The default type is PROBABILITY, pointwise confidence intervals on cumulative failure probability.

Interval Type	Definition
LIKELIHOOD \| LRCI	Likelihood ratio confidence intervals
PERCENTILES \| PER	Pointwise parametric confidence intervals for the percentiles of the fitted CDF
PROBABILITY \| CDF	Pointwise parametric confidence intervals for the cumulative failure probabilities. See the section Reliability Function for details.

PLOTDATA <DATA | MEDIANS | BOXES>

Requests that the data be plotted on the relationplot and specifies the representation of the data populations to be plotted.

PLOTFIT <number-list>

Specifies that percentiles of the fitted distribution be plotted on the relation plot. The optional number-list is a list of percentiles (between 0 and 100); if not specified, the 50th percentile (median) is plotted.

PPLEGEND = legend-statement-name

| NONE

Identifies a LEGENDn statement to specify legend for overlaid probability plots.

PPLOT

Places a probability plot on the same page as the relation plot.

RCENSYMBOL=symbol | (symbol-list)

Specifies symbols that represent right-censored and left-censored observations in a relation plot. The symbol is one of the symbol names (plus, star, square, diamond, triangle, hash, paw, point, dot, circle) or a letter (A–Z).

RPLEGEND = legend-statement-name

| NONE

Identifies a LEGENDn statement to specify legend for the relation plot.

SHOWMULTIPLES

Displays the count for multiple overlaying symbols.

TURNVLABELS

Vertically strings out characters in labels for vertical axis.

VOFFSET=value

Specifies length of offset at upper end of vertical axis.

WFIT=linetype

Specifies line width for fit line and confidence curves.

Table 14.43 lists plot layout options that are available when you use ODS graphics.

Table 14.43 Plot Layout Options for ODS Graphics

Option

Option Description

NOCENPLOT

Suppresses plotting of censored data points.

NOCONF

Suppresses plotting of percentile confidence curves.

NOFIT

Suppresses plotting of fit line and percentile confidence curves.

NOPPOS

Suppresses plotting of symbols for failures in a probability plot.

PINTERVALS=interval-type

Interval Type	Definition
LIKELIHOOD \| LRCI	Likelihood ratio confidence intervals
PERCENTILES \| PER	Pointwise parametric confidence intervals for the percentiles of the fitted CDF
PROBABILITY \| CDF	Pointwise parametric confidence intervals for the cumulative failure probabilities. See the section Reliability Function for details.

PLOTDATA

Requests that the data be plotted on the relationplot.

PLOTFIT <number-list>

PPLOT

Places a probability plot on the same page as the relation plot.

Table 14.44 lists reference line options that are available when you use traditional graphics.

Table 14.44 Reference Line Options for Traditional Graphics

Option

Option Description

HREF <(INTERSECT)>=value-list

Requests reference lines perpendicular to horizontal axis. If (INTERSECT) is specified, a second reference line perpendicular to the vertical axis is drawn that intersects the fit line at the same point as the horizontal axis reference line. If a horizontal axis reference line label is specified, the intersecting vertical axis reference line is labeled with the vertical axis value.

HREFLABELS=(’label1’ ...’labeln’)

Specifies labels for HREF= lines.

HREFLABPOS=n

Specifies the vertical position of labels for HREF= lines. The valid values for n and the corresponding label placements are shown in the following table:

n	Label Placement
1	Top
2	Staggered from top
3	Bottom
4	Staggered from bottom
5	Alternating from top
6	Alternating from bottom

LHREF=linetype

Specifies a line style for HREF= lines.

LSREF=linetype

Specifies a line style for SREF= lines.

LVREF=linetype

Specifies a line style for VREF= lines.

SREF=value-list

Specifies reference lines perpendicular to horizontal stress axis.

SREFLABELS=(’label1’ ...’labeln’)

Specifies labels for SREF= lines

SREFLABPOS=n

Specifies horizontal position of labels for SREF= lines. The valid values for n and the corresponding label placements are shown in the following table:

n	Label Placement
1	Top
2	Staggered from top
3	Bottom
4	Staggered from bottom

VREF <(INTERSECT)>=value-list

Requests reference lines perpendicular to vertical axis. If (INTERSECT) is specified, a second reference line perpendicular to the horizontal axis is drawn that intersects the fit line at the same point as the vertical axis reference line. If a vertical axis reference line label is specified, the intersecting horizontal axis reference line is labeled with the horizontal axis value.

VREFLABELS=(’label1’ ...’labeln’)

Specifies labels for VREF= lines.

VREFLABPOS=n

Specifies the horizontal position of labels for VREF= lines. The valid values for n and the corresponding label placements are shown in the following table:

n	Label Placement
1	Left
2	Right

Table 14.45 lists reference line options that are available when you use ODS graphics.

Table 14.45 Reference Line Options for ODS Graphics
Option	Option Description
PREF <(INTERSECT)>=value-list	Requests reference lines perpendicular to probability axis, if a probability plot is specified with the PPLOT option. If (INTERSECT) is specified, a second reference line perpendicular to the vertical axis is drawn that intersects the fit line at the same point as the horizontal axis reference line. If a horizontal axis reference line label is specified, the intersecting vertical axis reference line is labeled with the vertical axis value.
PREFLABELS=(’label1’ ...’labeln’)	Specifies labels for PREF= lines.
SREF=value-list	Specifies reference lines perpendicular to horizontal stress axis.
SREFLABELS=(’label1’ ...’labeln’)	Specifies labels for SREF= lines.
LREF <(INTERSECT)>=value-list	Requests reference lines perpendicular to vertical (lifetime) axis. If (INTERSECT) is specified, a second reference line perpendicular to the horizontal axis is drawn that intersects the fit line at the same point as the vertical axis reference line. If a vertical axis reference line label is specified, the intersecting horizontal axis reference line is labeled with the horizontal axis value.
LREFLABELS=(’label1’ ...’labeln’)	Specifies labels for LREF= lines.

Table 14.46 lists options that control the appearance of the text when you use traditional graphics. These options are not available if ODS Graphics is enabled.

Table 14.46 Text Enhancement Options
Option	Option Description
FONT=font	Specifies a software font for text.
HEIGHT=value	Specifies the height of text used outside framed areas.
INFONT=font	Specifies a software font for text inside framed areas.
INHEIGHT=value	Specifies the height of text inside framed areas.

Table 14.47 lists options that control the appearance of the axes when you use traditional graphics.

Table 14.47 Axis Options for Traditional Graphics
Option	Option Description
LAXIS=value1 TO value2<BY value3>	Specifies tick mark values for the lifetime axis. value1, value2, and value3 must be numeric, and value1 must be less than value2. The lower tick mark is value1. Tick marks are drawn at increments of value3. The last tick mark is the greatest value that does not exceed value2. If value3 is omitted, a value of 1 is used. This method of specification of tick marks is not valid for logarithmic axes. Examples of LAXIS= lists are laxis = -1 to 10 laxis = 0 to 200 by 10
LGRID=number	Specifies a line style for all grid lines. The number is between 1 and 46 and specifies a linestyle for grids.
LIFELOWER \| LLOWER=number	Specifies the lower limit on the lifetime axis scale. The LLOWER option specifies number as the lower lifetime axis tick mark. The tick interval and the upper lifetime axis limit are determined automatically. This option has no effect if the LAXIS option is used.
LIFEUPPER \| LUPPER=number	Specifies the upper limit on the lifetime axis scale. The LUPPER option specifies number as the upper lifetime axis tick mark. The tick interval and the lower lifetime axis limit are determined automatically. This option has no effect if the LAXIS option is used.
MPGRID	Adds a minor grid for the probability axis.
MINORLOGGRID	Adds a minor grid for log axes.
NOGRID	Suppresses grid lines.
NOLLABEL	Suppresses the label for the lifetime axis.
NOLTICK	Suppresses tick marks and tick mark labels for lifetime or analysis variable axis.
NOPLABEL	Suppresses the label for the probability axis.
NOPTICK	Suppresses tick marks and tick mark labels for probability axis.
NOSLABEL	Suppresses the label for the stress axis.
NOSTICK	Suppresses tick marks and tick mark labels for stress axis.
NSTRESSTICK=number	Specifies the number of tick intervals for stress axis for relation plot.
NTICK=number	Specifies the number of tick intervals for the lifetime axis. This option has no effect if the LAXIS option is used.
PCTLOWER \| PLOWER=number	Specifies the lower limit on the probability axis scale.
PCTUPPER \| PUPPER=number	Specifies the upper limit on the probability axis scale.
STRESSLOWER \| SLOWER=number	Specifies the lower limit on the stress axis scale.
STRESSUPPER \| SUPPER=number	Specifies the upper limit on the stress axis scale.
PAXISLABEL=‘string’	Specifies a label for the probability axis.
WAXIS=n	Specifies the line thickness for axes and frame.

Table 14.48 lists options that control the appearance of the axes when you use ODS Graphics.

Table 14.48 Axis Options for ODS Graphics
Option	Option Description
LIFELOWER \| LLOWER=number	Specifies the lower limit on the lifetime axis scale. The LLOWER option specifies number as the lower lifetime axis tick mark. The tick interval and the upper lifetime axis limit are determined automatically. This option has no effect if the LAXIS option is used.
LIFEUPPER \| LUPPER=number	Specifies the upper limit on the lifetime axis scale. The LUPPER option specifies number as the upper lifetime axis tick mark. The tick interval and the lower lifetime axis limit are determined automatically. This option has no effect if the LAXIS option is used.
NOGRID	Suppresses grid lines.
PCTLOWER \| PLOWER=number	Specifies lower the limit on the probability axis scale.
PCTUPPER \| PUPPER=number	Specifies upper the limit on the probability axis scale.
STRESSLOWER \| SLOWER=number	Specifies the lower limit on the stress axis scale.
STRESSUPPER \| SUPPER=number	Specifies the upper limit on the stress axis scale.
PAXISLABEL=‘string’	Specifies a label for the probability axis.

Table 14.49 lists options that control the use of a graphics catalog to store graphs if you use traditional graphics. These options are not available if ODS Graphics is enabled.

Table 14.49 Graphics Catalog Options
Option	Option Description
DESCRIPTION=‘string’	Description for graphics catalog member
NAME=‘string’	Name for plot in graphics catalog

Table 14.50 lists options that control colors and patterns used in the graph when you use traditional graphics. These options are not available if ODS Graphics is enabled.

Table 14.50 Color and Pattern Options
Option	Option Description
CAXIS=color	Color for axis
CBOXES=color	Color for box frame for boxplots
CBOXFILL=color	Color for filling boxes for boxplots
CCENSOR=color	Color for filling censor plot area
CENCOLOR=color	Color for censor symbol
CFIT=color \| (color-list)	color for fit lines and confidence curves in a probability plot
CFRAME=color	Color for frame
CGRID=color	Color for grid lines
CHREF=color	Color for HREF= lines
CPLOTFIT=color \| (color-list)	colors for percentile lines
CSREF=color	Color for SREF= lines
CTEXT=color	Color for text
CVREF=color	Color for VREF= lines
RCENCOLOR=color \| (color-list)	Colors for the symbols representing uncensored, right-censored, and left-censored observations in a relation plot