lme4 (version 0.999999-2)

HPDinterval: Highest Posterior Density intervals

Description

Create Highest Posterior Density (HPD) intervals for the parameters in an MCMC sample.

Usage

HPDinterval(object, prob = 0.95, ...)

Arguments

object

The object containing the MCMC sample - usually of class merMCMC or a numeric matrix.

prob

A numeric scalar in the interval (0,1) giving the target probability content of the intervals. The nominal probability content of the intervals is the multiple of 1/nrow(obj) nearest to prob.

...

Optional additional arguments for methods. None are used at present.

Value

• For an merMCMC object, a list of matrices with columns "lower" and "upper" and rows corresponding to the parameters. The attribute "Probability" is the nominal probability content of the intervals.

Details

For each parameter the interval is constructed from the empirical cdf of the sample as the shortest interval for which the difference in the ecdf values of the endpoints is the nominal probability. Assuming that the distribution is not severely multimodal, this is the HPD interval.