NetworkChangeRobust: Changepoint analysis of a degree-corrected multilinear tensor...

View source: R/NetworkChangeRobust.r

NetworkChangeRobustR Documentation

Changepoint analysis of a degree-corrected multilinear tensor model with t-distributed error

Description

NetworkChangeRobust implements Bayesian multiple changepoint models to network time series data using a degree-corrected multilinear tensor decomposition method with t-distributed error

Usage

NetworkChangeRobust(
  Y,
  R = 2,
  m = 1,
  initial.s = NULL,
  mcmc = 100,
  burnin = 100,
  verbose = 0,
  thin = 1,
  degree.normal = "eigen",
  UL.Normal = "Orthonormal",
  plotUU = FALSE,
  plotZ = FALSE,
  b0 = 0,
  B0 = 1,
  c0 = NULL,
  d0 = NULL,
  n0 = 2,
  m0 = 2,
  u0 = NULL,
  u1 = NULL,
  v0 = NULL,
  v1 = NULL,
  a = NULL,
  b = NULL
)

Arguments

Y

Reponse tensor

R

Dimension of latent space. The default is 2.

m

Number of change point. If m = 0 is specified, the result should be the same as NetworkStatic.

initial.s

The starting value of latent state vector. The default is sampling from equal probabilities for all states.

mcmc

The number of MCMC iterations after burnin.

burnin

The number of burn-in iterations for the sampler.

verbose

A switch which determines whether or not the progress of the sampler is printed to the screen. If verbose is greater than 0 the iteration number, the β vector, and the error variance are printed to the screen every verboseth iteration.

thin

The thinning interval used in the simulation. The number of MCMC iterations must be divisible by this value.

degree.normal

A null model for degree correction. Users can choose "NULL", "eigen" or "Lsym." "NULL" is no degree correction. "eigen" is a principal eigen-matrix consisting of the first eigenvalue and the corresponding eigenvector. " Lsym" is a modularity matrix. Default is "eigen."

UL.Normal

Transformation of sampled U. Users can choose "NULL", "Normal" or "Orthonormal." "NULL" is no normalization. "Normal" is the standard normalization. "Orthonormal" is the Gram-Schmidt orthgonalization. Default is "NULL."

plotUU

If plotUU = TRUE and verbose > 0, then the plot of the latent space will be printed to the screen at every verboseth iteration. The default is plotUU = FALSE.

plotZ

If plotZ = TRUE and verbose > 0, then the plot of the degree-corrected input matrix will be printed to the screen with the sampled mean values at every verboseth iteration. The default is plotUU = FALSE.

b0

The prior mean of β. This must be a scalar. The default value is 0.

B0

The prior variance of β. This must be a scalar. The default value is 1.

c0

= 0.1 The shape parameter of inverse gamma prior for σ^2.

d0

= 0.1 The rate parameter of inverse gamma prior for σ^2.

n0

= 0.1 The shape parameter of inverse gamma prior for γ of Student-t distribution.

m0

= 0.1 The rate parameter of inverse gamma prior for γ of Student-t distribution.

u0

u_0/2 is the shape parameter for the inverse Gamma prior on variance parameters for U. The default is 10.

u1

u_1/2 is the scale parameter for the inverse Gamma prior on variance parameters for U. The default is 1.

v0

v_0/2 is the shape parameter for the inverse Gamma prior on variance parameters for V. The default is 10.

v1

v_1/2 is the scale parameter for the inverse Gamma prior on variance parameters for V. The default is the time length of Y.

a

a is the shape1 beta prior for transition probabilities. By default, the expected duration is computed and corresponding a and b values are assigned. The expected duration is the sample period divided by the number of states.

b

b is the shape2 beta prior for transition probabilities. By default, the expected duration is computed and corresponding a and b values are assigned. The expected duration is the sample period divided by the number of states.

Value

An mcmc object that contains the posterior sample. This object can be summarized by functions provided by the coda package. The object contains an attribute Waic.out that contains results of WAIC and the log-marginal likelihood of the model (logmarglike). The object also contains an attribute prob.state storage matrix that contains the probability of state_i for each period

References

Jong Hee Park and Yunkyun Sohn. 2020. "Detecting Structural Change in Longitudinal Network Data." Bayesian Analysis. Vol.15, No.1, pp.133-157.

Peter D. Hoff 2011. "Hierarchical Multilinear Models for Multiway Data." Computational Statistics \& Data Analysis. 55: 530-543.

Siddhartha Chib. 1998. "Estimation and comparison of multiple change-point models." Journal of Econometrics. 86: 221-241.

Sumio Watanabe. 2010. "Asymptotic equivalence of Bayes cross validation and widely applicable information criterion in singular learning theory." Journal of Machine Learning Research. 11: 3571-3594. Siddhartha Chib. 1995. “Marginal Likelihood from the Gibbs Output.” Journal of the American Statistical Association. 90: 1313-1321.

See Also

NetworkStatic

Examples


   ## Not run: 
   set.seed(1973)
   ## Generate an array (30 by 30 by 40) with block transitions
   from 2 blocks to 3 blocks
   Y <- MakeBlockNetworkChange(n=10, T=40, type ="split")
   G <- 100 ## only 100 mcmc scans to save time
   ## Fit models
   out1 <- NetworkChangeRobust(Y, R=2, m=1, mcmc=G, burnin=G, verbose=G)
   ## plot latent node positions
   plotU(out1)
   ## plot layer-specific network generation rules
   plotV(out1)
   
## End(Not run)

NetworkChange documentation built on March 18, 2022, 7:52 p.m.