covariance_var: Standard variation of the covariance matrix

View source: R/standard.R

covariance_varR Documentation

Standard variation of the covariance matrix

Description

Computation of an updated GBN object after a variation of the covariance matrix.

Usage

covariance_var(gbn, entry, delta)

Arguments

gbn

object of class GBN.

entry

a vector of length 2 specifying the entry of the covariance matrix to vary.

delta

additive variation coefficient for the entry of the co-variation matrix given in entry.

Details

Let the original Bayesian network have a Normal distribution \mathcal{N}(\mu,\Sigma) and let entry be equal to (i,j). For a variation of the covariance matrix by an amount \delta, a variation matrix D is constructed as

D_{k,l}=\left\{ \begin{array}{ll} \delta & \mbox{if } k=i, l=j\\ \delta & \mbox{if } l=i, k=j \\ 0 & \mbox{otherwise} \end{array} \right.

Then the resulting distribution after the variation is \mathcal{N}(\mu,\Sigma +D), assuming \Sigma+ D is positive semi-definite.

Value

If the resulting covariance is positive semi-definite, covariance_var returns an object of class GBN with an updated covariance matrix. Otherwise it returns an object of class npsd.gbn, which has the same components of GBN but also has a warning entry specifying that the covariance matrix is not positive semi-definite.

References

Gómez-Villegas, M. A., Maín, P., & Susi, R. (2007). Sensitivity analysis in Gaussian Bayesian networks using a divergence measure. Communications in Statistics—Theory and Methods, 36(3), 523-539.

Gómez-Villegas, M. A., Main, P., & Susi, R. (2013). The effect of block parameter perturbations in Gaussian Bayesian networks: Sensitivity and robustness. Information Sciences, 222, 439-458.

See Also

mean_var, model_pres_cov

Examples

covariance_var(synthetic_gbn,c(1,1),3)
covariance_var(synthetic_gbn,c(1,2),-0.4)


bnmonitor documentation built on June 7, 2023, 5:19 p.m.