A wraper to compute the natural logarithm of the integrated likelihood function
Description
This function wraps existing built-in routines to construct
the natural logarithm of the integrated likelihood function. The constructed
loglikelihood can be directly used for numerical optimization
a numerical vector, with which numerical optimization routine such as optim can be
carried out directly. When the confluent Hypergeometric class is used, it is used to hold values
for range, tail, nugget, and nu if the smoothness parameter is estimated.
When the Matérn class or powered-exponential class is used, it is used to hold values
for range, nugget, and nu if the smoothness parameter is estimated.
The order of the parameter values in par cannot be changed. For tensor or ARD form correlation
functions, range and tail becomes a vector.
output
a matrix of outputs
H
a matrix of regressors in the mean function of a GaSP model.
d
an R object holding the distances. It should be a distance matrix for constructing isotropic correlation matrix,
or a list of distance matrices along each input dimension for constructing tensor or ARD types of correlation matrix.
covmodel
a list of two strings: family, form, where family indicates the family of covariance functions
including the Confluent Hypergeometric class, the Matérn class, the Cauchy class, the powered-exponential class. form indicates the
specific form of covariance structures including the isotropic form, tensor form, automatic relevance determination form.
family
CH
The Confluent Hypergeometric correlation function is given by
C(h)=Γ(ν)Γ(ν+α)U(α,1−ν,(βh)2),
where α is the tail decay parameter. β is the range parameter.
ν is the smoothness parameter. U(⋅) is the confluent hypergeometric
function of the second kind. For details about this covariance,
see Ma and Bhadra (2023; doi:10.1080/01621459.2022.2027775).
cauchy
The generalized Cauchy covariance is given by
C(h)={1+(ϕh)ν}−α/ν,
where ϕ is the range parameter. α is the tail decay parameter.
ν is the smoothness parameter with default value at 2.
matern
The Matérn correlation function is given by
C(h)=Γ(ν)21−ν(ϕh)νKν(ϕh),
where ϕ is the range parameter. ν is the smoothness parameter.
Kν(⋅) is the modified Bessel function of the second kind of order ν.
exp
This is the Matérn correlation with ν=0.5. This covariance should be specified as matern with smoothness parameter ν=0.5.
matern_3_2
This is the Matérn correlation with ν=1.5.
This covariance should be specified as matern with smoothness parameter ν=1.5.
matern_5_2
This is the Matérn correlation with ν=2.5.
This covariance should be specified as matern with smoothness parameter ν=2.5.
powexp
The powered-exponential correlation function is given by
C(h)=exp{−(ϕh)ν},
where ϕ is the range parameter. ν is the smoothness parameter.
gauss
The Gaussian correlation function is given by
C(h)=exp(−ϕ2h2),
where ϕ is the range parameter.
form
isotropic
This indicates the isotropic form of covariance functions. That is,
C(h)=C0(∥h∥;θ),
where ∥h∥ denotes the
Euclidean distance or the great circle distance for data on sphere. C0(⋅) denotes
any isotropic covariance family specified in family.
tensor
This indicates the tensor product of correlation functions. That is,
C(h)=∏i=1dC0(∣hi∣;θi),
where d is the dimension of input space. hi is the distance along the ith input dimension. This type of covariance structure has been often used in Gaussian process emulation for computer experiments.
ARD
This indicates the automatic relevance determination form. That is,
C(h)=C0(∑i=1dϕi2hi2;θ),
where ϕi denotes the range parameter along the ith input dimension.
smooth
The smoothness parameter ν in a correlation function.
smoothness_est
a logical value indicating whether the smoothness parameter is estimated.
Value
The natural logarithm of marginal or integrated likelihood