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 pp with qq covariates (log-PNAR(pp)).

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+q2p + 1 + q, where qq denotes the number of covariates.

W

The N×NN \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×qN \times q matrix of covariates (one for each column), where qq 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][-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)(i,j)-element is ρij\rho^{|i-j|}.

dof

The degrees of freedom for Student's t copula.

Details

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

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

νi,t=β0+h=1p(β1hXi,th+β2hYi,th)+l=1qδlZi,l \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 Xi,t=j=1NWijYj,tX_{i,t}=\sum_{j=1}^{N}W_{ij}Y_{j,t} is the network effect, i.e. the weighted average impact of node ii connections, with the weights of the mean being WijW_{ij}, the single element of the network matrix WW. The parameter β0\beta_{0} is the intercept of the model, β1h\beta_{1h} are the network coefficients, β2h\beta_{2h} are the autoregressive parameters, and δl\delta_{l} are the coefficients assocciated to the covariates Zi,lZ_{i,l}.

Value

A list including:

p2R

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

log_lambda

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

y

A TT×NTT \times N time series object matrix of simulated counts for NN time series over TTTT.

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]