ghkvec {bayesm} | R Documentation |
Compute GHK approximation to Multivariate Normal Integrals
Description
ghkvec
computes the GHK approximation to the integral of a multivariate normal density over a half plane defined by a set of truncation points.
Usage
ghkvec(L, trunpt, above, r, HALTON=TRUE, pn)
Arguments
L |
lower triangular Cholesky root of covariance matrix |
trunpt |
vector of truncation points |
above |
vector of indicators for truncation above(1) or below(0) on an element by element basis |
r |
number of draws to use in GHK |
HALTON |
if |
pn |
prime number used for Halton sequence (def: the smallest prime numbers, i.e. 2, 3, 5, ...) |
Value
Approximation to integral
Note
ghkvec
can accept a vector of truncations and compute more than one integral. That is, length(trunpt)/length(above)
number of different integrals, each with the same variance and mean 0 but different truncation points. See 'examples' below for an example with two integrals at different truncation points. The above
argument specifies truncation from above (1) or below (0) on an element by element basis. Only one vector of above is allowed but multiple truncation points are allowed.
The user can choose between two random number generators for the numerical integration: psuedo-random numbers by R::runif
or quasi-random numbers by a Halton sequence. Generally, the quasi-random (Halton) sequence is more uniformly distributed within domain, so it shows lower error and improved convergence than the psuedo-random (runif
) sequence (Morokoff and Caflisch, 1995).
For the prime numbers generating Halton sequence, we suggest to use the first smallest prime numbers. Halton (1960) and Kocis and Whiten (1997) prove that their discrepancy measures (how uniformly the sample points are distributed) have the upper bounds, which decrease as the generating prime number decreases.
Note: For a high dimensional integration (10 or more dimension), we suggest use of the psuedo-random number generator (R::runif
) because, according to Kocis and Whiten (1997), Halton sequences may be highly correlated when the dimension is 10 or more.
Author(s)
Peter Rossi, Anderson School, UCLA, perossichi@gmail.com.
Keunwoo Kim, Anderson School, UCLA, keunwoo.kim@gmail.com.
References
For further discussion, see Bayesian Statistics and Marketing by Rossi, Allenby, and McCulloch, Chapter 2.
For Halton sequence, see Halton (1960, Numerische Mathematik), Morokoff and Caflisch (1995, Journal of Computational Physics), and Kocis and Whiten (1997, ACM Transactions on Mathematical Software).
Examples
Sigma = matrix(c(1, 0.5, 0.5, 1), ncol=2)
L = t(chol(Sigma))
trunpt = c(0,0,1,1)
above = c(1,1)
# here we have a two dimensional integral with two different truncation points
# (0,0) and (1,1)
# however, there is only one vector of "above" indicators for each integral
# above=c(1,1) is applied to both integrals.
# drawn by Halton sequence
ghkvec(L, trunpt, above, r=100)
# use prime number 11 and 13
ghkvec(L, trunpt, above, r=100, HALTON=TRUE, pn=c(11,13))
# drawn by R::runif
ghkvec(L, trunpt, above, r=100, HALTON=FALSE)