The LIFEREG Procedure

INSET Statement

  • INSET <keyword-list> </ options>;

The box or table of summary information produced on plots made with the PROBPLOT statement is called an inset. You can use the INSET statement to customize the information that is displayed in the inset box as well as to customize the appearance of the inset box. To supply the information that is displayed in the inset box, you specify keywords corresponding to the information that you want shown. For example, the following statements produce a probability plot with the number of observations, the number of right-censored observations, the name of the distribution, and the estimated Weibull shape parameter in the inset:

proc lifereg data=epidemic;
   model life = dose / dist = Weibull;
   probplot;
   inset nobs right dist shape;
run;

By default, inset entries are identified with appropriate labels. However, you can provide a customized label by specifying the keyword for that entry followed by the equal sign (=) and the label in quotes. For example, the following INSET statement produces an inset containing the number of observations and the name of the distribution, labeled "Sample Size" and "Distribution" in the inset:

inset nobs='Sample Size' dist='Distribution';

If you specify a keyword that does not apply to the plot you are creating, then the keyword is ignored.

If you specify more than one INSET statement, only the first one is used.

Table 57.5 lists keywords available in the INSET statement to display summary statistics, distribution parameters, and distribution fitting information.

Table 57.5: INSET Statement Keywords

Keyword

Description

CONFIDENCE

Confidence coefficient for all confidence intervals

DIST

Name of the distribution

INTERVAL

Number of interval-censored observations

LEFT

Number of left-censored observations

NOBS

Number of observations

NMISS

Number of observations with missing values

RIGHT

Number of right-censored observations

SCALE

Value of the scale parameter

SHAPE

Value of the shape parameter

UNCENSORED

Number of uncensored observations


The following options control the appearance of the box when you use traditional graphics. These options are not available if ODS Graphics is enabled. Table 57.6 summarizes the options available in the INSET statement.

Table 57.6: INSET Statement Options

Option

Description

CFILL=

Specifies the color for the filling box

CFILLH=

Specifies the color for the filling box header

CFRAME=

Specifies the color for the frame

CHEADER=

Specifies the color for text in the header

CTEXT=

Specifies the color for the text

FONT=

Specifies the software font for the text

HEIGHT=

Specifies the height of the text

HEADER=

Specifies the text for the header or box title

NOFRAME

Omits the frame around the box

POS=

Determines the position of the inset

REFPOINT=

Specifies the reference point for an inset


All options are specified after the slash (/) in the INSET statement.

CFILL=color

specifies the color for the filling box.

CFILLH=color

specifies the color for the filling box header.

CFRAME=color

specifies the color for the frame.

CHEADER=color

specifies the color for text in the header.

CTEXT=color

specifies the color for the text.

FONT=font

specifies the software font for the text.

HEIGHT=value

specifies the height of the text.

HEADER=’quoted string’

specifies the text for the header or box title.

NOFRAME

omits the frame around the box.

POS=value <DATA | PERCENT>

determines the position of the inset. The value can be a compass point (N, NE, E, SE, S, SW, W, NW) or a pair of coordinates (x, y) enclosed in parentheses. The coordinates can be specified in screen percentage units or axis data units. The default is screen percentage units.

REFPOINT=name

specifies the reference point for an inset that is positioned by a pair of coordinates with the POS= option. You use the REFPOINT= option in conjunction with the POS= coordinates. The REFPOINT= option specifies which corner of the inset frame you have specified with coordinates (x, y), and it can take the value of BR (bottom right), BL (bottom left), TR (top right), or TL (top left). The default is REFPOINT=BL. If the inset position is specified as a compass point, then the REFPOINT= option is ignored.