| Title: | Minimum Energy Designs |
|---|---|
| Description: | This is a method (MinED) for mining probability distributions using deterministic sampling which is proposed by Joseph, Wang, Gu, Lv, and Tuo (2019) <DOI:10.1080/00401706.2018.1552203>. The MinED samples can be used for approximating the target distribution. They can be generated from a density function that is known only up to a proportionality constant and thus, it might find applications in Bayesian computation. Moreover, the MinED samples are generated with much fewer evaluations of the density function compared to random sampling-based methods such as MCMC and therefore, this method will be especially useful when the unnormalized posterior is expensive or time consuming to evaluate. This research is supported by a U.S. National Science Foundation grant DMS-1712642. |
| Authors: | Dianpeng Wang and V. Roshan Joseph |
| Maintainer: | Dianpeng Wang <[email protected]> |
| License: | LGPL-2.1 |
| Version: | 1.0-3 |
| Built: | 2024-12-13 06:35:10 UTC |
| Source: | CRAN |
Generate minimum energy design (MinED) samples from an unnormalized probability density function. The asymptotic distribution of MinED samples converges to the target distribution and therefore, MinED can be viewed as a deterministic sample from the target distribution. The details of MinED and the algorithm used for generating it can be found in Joseph, Dasgupta, Tuo, and Wu (2015) and Joseph, Wang, Gu, Lv, and Tuo (2019). This research is supported by a U.S. National Science Foundation grant DMS-1712642.
| Package: | mined |
| Type: | Package |
| Version: | 1.0-3 |
| Date: | 2022-06-19 |
| License: | LGPL-2.1 |
Important functions in this package are: mined generates Minimum Energy Design samples from an unnormalized density function, SelectMinED selects Minimum Energy Design samples from candidate points, and Lattice generates good rank-1 lattice rules.
Dianpeng Wang and V. Roshan Joseph
Maintainer: Dianpeng Wang <[email protected]>
Joseph, V. R., Dasgupta, T., Tuo, R., and Wu, C. F. J. (2015). "Sequential Exploration of Complex Surfaces Using Minimum Energy Designs". Technometrics, 57, 64-74.
Joseph, V. R., Wang, D., Gu, L., Lv, S., and Tuo, R. (2019). "Deterministic Sampling of Expensive Posteriors Using Minimum Energy Designs", Technometrics, 61, 297-308, arXiv:1712.08929, DOI:10.1080/00401706.2018.1552203.
Generate good rank-1 lattice points with prime number of points by using the fast component-by-component construction algorithm of Nuyens and Cools (2006). Refer Nuyens (2007) for more details.
Lattice(n, p)Lattice(n, p)
n |
The number of points, which should be a prime. |
p |
The number of dimensions. |
An n-by-p matrix containing the good lattice points.
Dianpeng Wang <[email protected]> and V. Roshan Joseph <[email protected]>
Nuyens, D. and Cools, R. (2006). "Fast algorithms for component-by-component construction of rank-1 lattice rules in shift-invariant reproducing kernel Hilbert spaces.", Mathematics of Computation, 75, 903-920.
Nuyens, D. (2007). "Fast Construction of Good Lattice Rules.", Ph.D Thesis, Katholieke Universiteit Leuven, Leuven, Belgium.
library(mined) res <- Lattice(101, 2) plot(res[, 1], res[, 2], col='red',xlab='First dimension', ylab='Second dimension', pch=15)library(mined) res <- Lattice(101, 2) plot(res[, 1], res[, 2], col='red',xlab='First dimension', ylab='Second dimension', pch=15)
Generate MinED samples from an unnormalized density function.
mined(initial, logf, K_iter = 0)mined(initial, logf, K_iter = 0)
initial |
An n-by-p matrix containing the initial uniform samples from |
logf |
An R function to compute the logarithm of unnormalized density function. The input region should be scaled in |
K_iter |
The number of iteration steps for annealed version of the unnormalized posterior density. Optional, default is |
This is the main function of the package, which is used for generating the MinED samples. The MinED sample can be viewed as a deterministic sample from the probability density specified in the mined function. Since only the unnormalized density is needed to generate the MinED samples, this method could be used in Bayesian computation to approximate the posterior. The method uses few evaluations of the unnormalized posterior compared to random sampling-based methods and therefore, it will be useful when the evaluations are expensive or time consuming.
There are many parameters that control the performance of the algorithm, which are fixed at some reasonable values as specified in Joseph et al. (2019). The only thing user need to choose is the region for scaling the variables in [0,1]^p. Ideally it should be the highercube containing the highest posterior density region with good coverage. However, the algorithm is robust to this choice to some extend as it can shrink or expand from the intial region. Therefore, it can be chosen based on user's guessed range of each variable.
The value returned from the function is a list containing the following components:
points |
A matrix containing |
logf |
Log-unnormalized density function values of MinED samples. |
cand |
Full set of samples used in the algorithm. |
candlf |
Log-unormalized density function values of the samples in |
Dianpeng Wang <[email protected]> and V. Roshan Joseph <[email protected]>
Joseph, V. R., Wang, D., Gu, L., Lv, S., and Tuo, R. (2019). "Deterministic Sampling of Expensive Posteriors Using Minimum Energy Designs", Technometrics, 61, 297-308, arXiv:1712.08929, DOI:10.1080/00401706.2018.1552203.
require(mined) p <- 2 n <- 109 # largest prime number less than 100+5p initial <- Lattice(n, p) # suppose x1 is in [-40,40] and x2 in [-25,10] logf <- function(para) { l1 <- -40 u1 <- 40 l2 <- -25 u2 <- 10 x1 <- l1 + (u1 - l1) * para[1] x2 <- l2 + (u2 - l2) * para[2] val <- -.5 * (x1 ^2 / 100 + (x2+ .03 * x1^2 -3)^2) return(val) } res <- mined::mined(initial, logf, K_iter = 8) dim(res$points) dim(res$cand) x1 <- seq(0, 1, length.out = 200) x2 <- seq(0, 1, length.out = 200) y <- matrix(0.0, 200, 200) for(i in 1:200) { for(j in 1:200) { y[i, j] = logf(c(x1[i], x2[j])) } } image(x1, x2, exp(y), col = cm.colors(5), xlab = expression(x[1]), ylab = expression(x[2])) points(res$cand[, 1], res$cand[, 2], pch = 11, col = rgb(red = 0, green = 0, blue = 1, alpha = 0.35), cex = .25) points(res$points[, 1], res$points[, 2], pch = 17, col = 'black', cex = .75) legend("bottom", c('Candidates points', 'MinED samples'), pch = c(11, 17), col = c(rgb(red = 0, green = 0, blue = 1, alpha = 0.35), 'black'), inset = .02, bg = 'transparent', bty = 'n')require(mined) p <- 2 n <- 109 # largest prime number less than 100+5p initial <- Lattice(n, p) # suppose x1 is in [-40,40] and x2 in [-25,10] logf <- function(para) { l1 <- -40 u1 <- 40 l2 <- -25 u2 <- 10 x1 <- l1 + (u1 - l1) * para[1] x2 <- l2 + (u2 - l2) * para[2] val <- -.5 * (x1 ^2 / 100 + (x2+ .03 * x1^2 -3)^2) return(val) } res <- mined::mined(initial, logf, K_iter = 8) dim(res$points) dim(res$cand) x1 <- seq(0, 1, length.out = 200) x2 <- seq(0, 1, length.out = 200) y <- matrix(0.0, 200, 200) for(i in 1:200) { for(j in 1:200) { y[i, j] = logf(c(x1[i], x2[j])) } } image(x1, x2, exp(y), col = cm.colors(5), xlab = expression(x[1]), ylab = expression(x[2])) points(res$cand[, 1], res$cand[, 2], pch = 11, col = rgb(red = 0, green = 0, blue = 1, alpha = 0.35), cex = .25) points(res$points[, 1], res$points[, 2], pch = 17, col = 'black', cex = .75) legend("bottom", c('Candidates points', 'MinED samples'), pch = c(11, 17), col = c(rgb(red = 0, green = 0, blue = 1, alpha = 0.35), 'black'), inset = .02, bg = 'transparent', bty = 'n')
Select MinED samples from candidates by optimizing the generalized MinED criterion in Joseph et al. (2019).
SelectMinED(candidates, candlf, n, gamma=1, s=2)SelectMinED(candidates, candlf, n, gamma=1, s=2)
candidates |
Candidate samples from the target distribution, which can be MC, QMC, or MCMC samples. |
candlf |
The log-unnormalized density function values corresponding to the |
n |
The required number of MinED samples. |
gamma |
The parameter in the anealled version of density function. Optional, default is “1”. |
s |
The parameter in generalized distance. Optional, default is “2”. |
This function select MinED samples from a given set of candidate samples. The function is used internally in the mined function repeatedly for K times, where K is the number of annealing steps in the algorithm. Refer to Joseph et al., (2018) for more details.
The value returned from the function is a list containing the following components:
points |
The MinED samples selected from the |
logf |
The log-unnormalized density function values of the |
Dianpeng Wang <[email protected]> and V. Roshan Joseph <[email protected]>
Joseph, V. R., Wang, D., Gu, L., Lv, S., and Tuo, R. (2019). "Deterministic Sampling of Expensive Posteriors Using Minimum Energy Designs", Technometrics, 61, 297-308, arXiv:1712.08929, DOI:10.1080/00401706.2018.1552203.
cand <- matrix(runif(10000, min = -4, max = 4), ncol = 1) candlf <- log(dnorm(cand)) res <- mined::SelectMinED(cand, as.vector(candlf), 150, 1.0, 2.0) print(res) par(mfrow=c(1,2)) hist(cand) hist(res$points)cand <- matrix(runif(10000, min = -4, max = 4), ncol = 1) candlf <- log(dnorm(cand)) res <- mined::SelectMinED(cand, as.vector(candlf), 150, 1.0, 2.0) print(res) par(mfrow=c(1,2)) hist(cand) hist(res$points)