1. Home
  2. DPROBABILITY procedure

DPROBABILITY procedure

Plots probability distributions, and estimates their parameters (D.B. Baird).

Options

PRINT = string tokens Controls whether to print estimated parameters of the distribution or test statistics (parameters, tests); default para
DISTRIBUTION = string token Distribution for expected values against which to plot values (normal, stdnormal, lognormal, exponential, expnormal, gamma, weibull, beta, b2, pareto, chisquare, cauchy, logistic, ev1, ev2, ev3, gev, invnormal, t, f, uniform, skewnormal, stduniform, laplace, gpareto, ubetamix, ugammamix, loggamma, loglogistic, paralogistic, igamma, iweibull, burr, iburr); default norm
METHOD = string token Method used for the plot axes (quantile, probability, stabilizedprobability); default quan
GRAPHICS = string token Type of graphics (highresolution, lineprinter); default high
PLOT = string tokens Whether to plot differences from expectations or the 1-1 reference line (differences, reference); default refe
CONSTANT = string token Whether to estimate the constant for the distribution (estimate, omit) default omit
BANDS = string token What type of confidence bands to plot, if any (simultaneous, pointwise); default simu
NSIMULATIONS = scalar Number of simulations for pointwise bands; default 100
ALPHA = scalar Acceptance limits for confidence bands; default 0.95
DF = scalar Number of degrees of freedom of chi-square or t distribution; default 1
DFNUMERATOR = scalar Numerator degrees of freedom of F distribution; default 1
DFDENOMINATOR = scalar Denominator degrees of freedom of F distribution; default 1
WINDOW = scalar Window to use for the plot; default 3
XMETHOD = string token Scaling of X / Expected Plot axes (quantile, probability, stabilizedprobability); if unset, takes the same setting as METHOD
QMETHOD = string token Whether to standardize plotted score in expected quantiles (standardized, unstandardized); default stan
TMETHOD = string tokens Specifies the method used to perform the goodness-of-fit tests (likelihoodratio, traditional); default like
NTIMES = scalar Number of Monte-Carlo simulations to perform for likelihood-ratio tests; default 999
SEED = scalar Seed for random number generation for the likelihood-ratio tests; default 0 continues an existing sequence or, if none, selects a seed automatically

Parameters

DATA = variates Values to plot
TITLE = text Title for the graph; default * generates an appropriate title automatically
ESTIMATES = variates Saves the estimated parameters for the distribution
SE = variates Saves standard errors for the estimated parameters
LOWERTRUNCATION = scalars Lower truncation points for Loss distributions
UPPERTRUNCATION = scalars Upper truncation points for Loss distributions
DEVIANCE = scalars Saves the deviance for the fitted distribution
PROBABILITIES = variates Saves the probabilities from the goodness-of-fit tests

Description

To assess the how well empirical data approximates a particular theoretical distribution, DPROBABILITY plots the sorted values (order statistics, Xi) against the expected values of the order statistics Ei from the given distribution. However, usually the particular parameters of the distribution are not known and these have to be estimated first to obtain the expected values.

If the distribution has a cumulative density function of F(x), and the inverse of this function is G(x) (i.e. G(F(x)) = x), then the expected values of the order statistics, are approximately G((i-0.5)/n), where i = 1…n, and n is the number of values in the sample. A plot of Xi versus Ei is known as a Quantile-Quantile (or Q-Q) plot. The data can also be plotted on the probability scale by plotting the cumulative probabilities of the data under the assumed distribution against their expected probabilities, i.e. F(X(i)) versus (i-0.5)/n. This is known as a Probability-Probability (or P-P) plot.

A third plot called the stabilized probability (SP) plot (Michael 1983), was introduced, which rescales the probabilities using the transformation

sp = (2/π) × ARCSIN(SQRT(p))

so that the variance of the plotted points is approximately equal over the range of probability values. In the SP plot the scaled values sp are plotted rather than the unscaled p values. The METHOD option allows the choice of which scale is used in the graph (quantile, probability or stabilizedprobability for the Q-Q, P-P or SP plots respectively).

By default the x-value used in plotting Q, P or SP is the corresponding expected value of these statistics. Alternative x-values can be used by setting the XMETHOD option to quantile, probability, or stabilizedprobability. So for example a Q-P plot can be obtained with the option settings METHOD=quantile and XMETHOD=probability or a P-Q plot with the settings METHOD=probability and XMETHOD=quantile.

The QMETHOD option allows the scaling of the expected quantiles plotted on the x-axis to be set. By default quantiles are standardized to have a mean of zero and variance of one (as in a normal score plot) but, if QMETHOD=unstandardized, the quantiles are scaled to the same mean and variance as the data.

The DATA parameter specifies the data values, in a variate. The TITLE parameter can specify a title for the graph. The ESTIMATES parameter can be used to save the values estimated for the parameters for the distribution, and the SE parameter can save their standard errors.

The distribution for the expected values against which to plot the data is specified by the DISTRIBUTION option. Some distributions (Log-Normal, Gamma, Weibull and Pareto) can have an extra parameter (a) estimated, so that Xa follows the specified distribution. Setting option CONSTANT=estimate estimates a value for a. Some of the distributions (Chi Square, T and F) cannot have the parameters estimated by the usual DISTRIBUTION directive, so the procedure provides 3 options (DF, DFNUMERATOR, DFDENOMINATOR) for specifying the parameters of these distributions. However, if for example you set DF=*, the degrees of freedom are estimated along with the other parameters of the distribution.

Some distributions (normal, loggamma, loglogistic, paralogistic, igamma, iweibull, burr, iburr) can be estimated and plotted in a truncated form. The values in the distribution less than LOWERTRUNCATION and greater than UPPERTRUNCATION are removed (if either of these are set), and the distribution between these limits is rescaled to have an area of one. If only LOWERTRUNCATION is set, the distribution is left-truncated, and it is right-truncated if only UPPERTRUNCATION is set.

The BANDS option allows two forms of confidence intervals to be displayed in the graph. BANDS=pointwise simulates NSIMULATIONS distributions of the same size as the data, from the theoretical distribution, and plots the range of values at each value of the order statistics that contain the proportion specified by the option ALPHA of simulated values. Thus a sample drawn from the assumed distribution has approximately a probability ALPHA of lying within the limits at each point. However, overall there will be a probability of less than ALPHA that a sample will completely lie within the confidence bands. The BANDS=simultaneous uses a statistic given by Michael (1983) for which the overall probability of plotted data lying completely within the confidence bands is approximately the specified value of ALPHA, under the null hypothesis that the data is a random sample from the specified distribution. This form of confidence limits has the advantage that it is much faster to calculate and that probability of the data points falling outside the limits is approximately constant over the range of the data.

When plotting the data against the expected values, setting option PLOT=reference allows the 1-1 line to be added to the graph, so that departures from this can be more easily observed. The other PLOT setting, difference, plots the difference between the data and the expected values, so that departures can be observed more easily in a horizontal direction rather than on a 45 degree slant. Setting option GRAPHICS=lineprinter produces a character based graph in the output window rather than in the high-resolution graphics window as usual. The WINDOW option can be used to specify which graphics window to use for a high-resolution graph.

The PRINT option control of the output that is printed. The parameters setting prints the fitted parameters of the specified distribution, and some sample statistics of the observed data. The test setting provides output from three empirical distribution tests, namely the Anderson-Darling, Cramer-von Mises and Watson statistics. The method used to perform these tests is specified by the TMETHOD option, with settings likelihoodratio for the Zhang (2002) likelihood-ratio based method, and traditional for the traditional approach. The default is to use the likelihood-ratio based tests, which are generally more powerful. Monte-Carlo simulations are used to calculate the empirical probability values of the test statistics under the likelihood-ratio based method. The NTIMES option defines how many Monte-Carlo simulations are used; default 999. The SEED option specifies the seed for the random-number generator used during the Monte-Carlo simulations. The default of zero continues the sequence of random numbers from a previous generation or, if this is the first use of the generator in this run of Genstat, the seed is initialized automatically. The test probabilities can be saved, in a variate, by the PROBABILITIES parameter.

The distributions fitted in this procedure are described further in the books by Hogg & Klugman (1984) and Johnson, Kotz & Balakrishnan (1994, 1995).

Options: PRINT, DISTRIBUTION, METHOD, GRAPHICS, PLOT, CONSTANT, BANDS, NSIMULATIONS, ALPHA, DF, DFNUMERATOR, DFDENOMINATOR, WINDOW, XMETHOD, QMETHOD, TMETHOD, NTIMES, SEED.

Parameters: DATA, TITLE, ESTIMATES, SE, LOWERTRUNCATION, UPPERTRUNCATION, DEVIANCE, PROBABILITIES.

Method

The parameters for the distribution are estimated using the DISTRIBUTION or FITNONLINEAR directives. The cumulative distribution probability values of the observed and expected values are calculated with the CL series of functions. The goodness-of-fit tests are performed by the EDFTEST procedure.

Action with RESTRICT

If the DATA variate is restricted, the plots and tests will be calculated using only the units included by the restriction.

Reference

Hogg, R. V. & Klugman, S. A. (1984). Loss Distributions. John Wiley & Sons, New York.

Johnson, N. L., Kotz, S. & Balakrishnan N. (1994). Continuous Univariate Distributions, Volume 1, 2nd edition. John Wiley & Sons, New York.

Johnson, N. L., Kotz, S. & Balakrishnan N. (1995). Continuous Univariate Distributions, Volume 2, 2nd edition. John Wiley & Sons, New York.

Michael, J. R. (1983). The stabilized probability plot. Biometrika, 70, 11-17.

Zhang (2002). Powerful goodness-of-fit tests based on the likelihood ratio. Journal of the Royal Statistical Society, Series B, 64, 281-294.

See also

Directive: DISTRIBUTION.

Procedures: BBINOMIAL, EDFTEST, MAVOLCANO.

Commands for: Graphics, Basic and nonparametric statistics.

Example

CAPTION      'DPROBABILITY example'; STYLE=major
CALCULATE    [SEED=287987] N = GRNORMAL(100;1;2)
DPROBABILITY [PRINT=parameters,tests; DISTRIBUTION=normal] N
DPROBABILITY [PRINT=*; DISTRIBUTION=Normal; METHOD=probability;\
             BANDS=pointwise; ALPHA=0.99; NSIMULATIONS=400] N
DPROBABILITY [PRINT=*; DISTRIBUTION=normal; METHOD=stabilized;\
             BANDS=simultaneous; PLOT=difference] N
CALCULATE    C = GRCHISQUARE(1000;3)
DPROBABILITY [PRINT=tests; DISTRIBUTION=chiSquare; DF=3; METHOD=probability;\
             BANDS=*] C; TITLE='Chi Square 3 df P-P plot'
Updated on February 7, 2023

Was this article helpful?