poisson.MODpq.log {PNAR}R Documentation

Generation of multivariate count time series from a log-linear Poisson NAR(p) model with q covariates (log-PNAR(p))

Description

Generation of counts from a log-linear Poisson Network Autoregressive model of order p with q covariates (log-PNAR(p)).

Usage

poisson.MODpq.log(b, W, p, Z = NULL, TT, N, copula = "gaussian",
corrtype = "equicorrelation", rho, dof = 1)

Arguments

b

The coefficients of the model, in the following order: (intercept, network parameters, autoregressive parameters, covariates). The dimension of the vector should be 2p + 1 + q, where q denotes the number of covariates.

W

The N \times N row-normalized non-negative adjacency matrix describing the network. The main diagonal entries of the matrix should be zeros, all the other entries should be non-negative and the maximum sum of elements over the rows should equal one.The function row-normalizes the matrix if a non-normalized adjacency matrix is provided.

p

The number of lags in the model.

Z

An N \times q matrix of covariates (one for each column), where q is the number of covariates in the model.

TT

The temporal sample size.

N

The number of nodes on the network.

copula

Which copula function to use? The "gaussian", "t", or "clayton".

rho

The the value of the copula parameter (\rho). A scalar in [-1,1] for elliptical copulas (Gaussian, t), a value greater or equal to -1 for Clayton copula.

corrtype

Used only for elliptical copulas. The type of correlation matrix employed for the copula; it will either be the "equicorrelation" or "toeplitz". The "equicorrelation" option generates a correlation matrix where all the off-diagonal entries equal \rho. The "toeplitz" option generates a correlation matrix whose generic off-diagonal (i,j)-element is \rho^{|i-j|}.

dof

The degrees of freedom for Student's t copula.

Details

This function generates counts from a log-linear Poisson NAR(p) model, where q non time-varying covariates are allowed as well. The counts are simulated from Y_{t}=N_{t}(e^{\nu_{t}}), where N_{t} is a sequence of N-dimensional IID Poisson count processes, with intensity 1, and whose structure of dependence is modelled through a copula construction C(\rho) on their associated exponential waiting times random variables. For details see Armillotta and Fokianos (2022, Sec. 2.1-2.2).

The sequence \nu_{t} is the log of the expecation of Y_{t}, conditional to its past values and it is generated by means of the following log-PNAR(p) model. For each node of the network i=1,...,N over the time sample t=1,...,TT

\nu_{i,t}=\beta_{0}+\sum_{h=1}^{p}(\beta_{1h}X_{i,t-h}+\beta_{2h}Y_{i,t-h})+\sum_{l=1}^{q}\delta_{l}Z_{i,l}

where X_{i,t}=\sum_{j=1}^{N}W_{ij}Y_{j,t} is the network effect, i.e. the weighted average impact of node i connections, with the weights of the mean being W_{ij}, the single element of the network matrix W. The parameter \beta_{0} is the intercept of the model, \beta_{1h} are the network coefficients, \beta_{2h} are the autoregressive parameters, and \delta_{l} are the coefficients assocciated to the covariates Z_{i,l}.

Value

A list including:

p2R

The Toeplitz correlation matrix, if employed in the copula or NULL else.

log_lambda

A TT \times N time series object matrix of simulated Poisson log-means for N time series over TT.

y

A TT \times N time series object matrix of simulated counts for N time series over TT.

Author(s)

Mirko Armillotta, Michail Tsagris and Konstantinos Fokianos.

References

Armillotta, M. and K. Fokianos (2022). Poisson network autoregression. https://arxiv.org/abs/2104.06296

Fokianos, K., Stove, B., Tjostheim, D., and P. Doukhan (2020). Multivariate count autoregression. Bernoulli, 26(1), 471-499.

See Also

poisson.MODpq, poisson.MODpq.nonlin, poisson.MODpq.stnar, poisson.MODpq.tnar

Examples

W <- adja( N = 20, K = 5, alpha= 0.5)
y <- poisson.MODpq.log( b = c(0.5, 0.3, 0.2), W = W, p = 1,
Z = NULL, TT = 1000, N = 20, copula = "gaussian",
corrtype = "equicorrelation", rho = 0.5)$y

[Package PNAR version 1.6 Index]