Learn R Programming

PNAR (version 1.7)

poisson.MODpq.log: 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)

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\).

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.

Author

Mirko Armillotta, Michail Tsagris and Konstantinos Fokianos.

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 (2024, 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}\).

References

Armillotta, M. and K. Fokianos (2023). Nonlinear network autoregression. Annals of Statistics, 51(6): 2526--2552.

Armillotta, M. and K. Fokianos (2024). Count network autoregression. Journal of Time Series Analysis, 45(4): 584--612.

Armillotta, M., Tsagris, M. and Fokianos, K. (2024). Inference for Network Count Time Series with the R Package PNAR. The R Journal, 15/4: 255--269.

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

Run this code
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

Run the code above in your browser using DataLab