The RAREEVENTS Procedure(Experimental)

Common CHART and COMPARE Statement Options

You can specify the following options after a slash (/) in a CHART or COMPARE statement.

DIST=distribution

specifies the probability distribution that is compared to the input data by a COMPARE statement and that is used to compute probability limits for a rare events chart that you create by using a CHART statement. You can specify the following distributions:

EXPONENTIAL<(exponential-options)>

requests an exponential distribution. You can specify the following exponential-options:

SIGMA=$\sigma $

specifies the scale parameter for the exponential distribution. By default, $\sigma $ is estimated from the process data.

THETA=$\theta $ | EST

specifies the threshold parameter for the exponential distribution. By default, $\theta =0$. You can specify THETA=EST to compute an estimate of $\theta $ from the process data. If any data value is less than $\theta $, the procedure issues a warning and sets $\theta $ to the minimum data value.

GEOMETRIC<(geometric-options)>

requests a geometric distribution. You can specify the following geometric-options:

P=p | MLE | MVUE

specifies the probability of success in a single Bernoulli trial on which the geometric distribution is based. This is the probability that an opportunity for a rare event to occur will actually result in an occurrence. You can specify P=MLE to compute a maximum likelihood estimate (MLE) of p or P=MVUE to compute a minimum variance unbiased estimate (MVUE) of p. By default, an MVUE is computed if the SHIFT= parameter value is 0 or 1, and an MLE is computed otherwise.

SHIFT=a

specifies the minimum possible value ($a \ge 0$) for the geometric distribution. By default, $a=0$. If a measurement from the input data represents the time until an event occurs (including the event itself) instead of times between events, then you should specify $a = 1$. If any data value is less than a, the procedure issues a warning and sets a to the minimum data value.

The procedure determines whether the process data have continuous or integer values. By default, an exponential distribution is used for continuous data and a geometric distribution is used for integer data.

NOHLABEL

suppresses the horizontal axis label in the graph.

NOVLABEL

suppresses the vertical axis label in the graph.

ODSFOOTNOTE=FOOTNOTE | FOOTNOTE1 | 'string'

adds a footnote to the graph. If you specify the FOOTNOTE (or FOOTNOTE1) keyword, the value of the SAS FOOTNOTE statement is used as the graph footnote. If you specify a quoted string, that string is used as the footnote. The quoted string can contain the following escape characters, which are replaced by the values indicated:

$\backslash $n

is replaced by the process variable name.

$\backslash $l

is replaced by the process variable label (or name if the process variable has no label).

ODSFOOTNOTE2=FOOTNOTE2 | 'string'

adds a secondary footnote to the graph. If you specify the FOOTNOTE2 keyword, the value of the SAS FOOTNOTE2 statement is used as the secondary graph footnote. If you specify a quoted string, that string is used as the secondary footnote. The quoted string can contain the following escape characters, which are replaced by the values indicated:

$\backslash $n

is replaced by the process variable name.

$\backslash $l

is replaced by the process variable label (or name if the process variable has no label).

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

specifies a title for the graph. You can specify the following values:

TITLE (or TITLE1)

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

NONE

suppresses all graph titles.

DEFAULT

uses the default title.

If you specify a quoted string, that string is used as the graph title. The quoted string can contain the following escape characters, which are replaced by the values indicated:

$\backslash $n

is replaced by the process variable name.

$\backslash $l

is replaced by the process variable label (or name if the analysis variable has no label).

ODSTITLE2=TITLE2 | 'string'

specifies a secondary title for the graph. If you specify the TITLE2 keyword, the value of the SAS TITLE2 statement is used as the secondary graph title. If you specify a quoted string, that string is used as the secondary title. The quoted string can contain the following escape characters, which are replaced by the values indicated:

$\backslash $n

is replaced by the process variable name.

$\backslash $l

is replaced by the process variable label (or name if the analysis variable has no label).