naginterfaces.library.tsa.multi_​corrmat_​partlag

naginterfaces.library.tsa.multi_corrmat_partlag(n, r0, r)

multi_corrmat_partlag calculates the sample partial lag correlation matrices of a multivariate time series. A set of ${\chi }^2$-statistics and their significance levels are also returned. A call to multi_corrmat_cross() is usually made prior to calling this function in order to calculate the sample cross-correlation matrices.

For full information please refer to the NAG Library document for g13dn

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/g13/g13dnf.html

Parameters

nint

$n$, the number of observations in each series.

r0float, array-like, shape $(k,k)$

If $i\ne j$, then $r0[i-1,j-1]$ must contain the $(i,j)$th element of the sample cross-correlation matrix at lag zero, ${\hat{R}}_{ij}\left(0\right)$. If $i=j$, then $r0[i-1,i-1]$ must contain the standard deviation of the $i$th series.

rfloat, array-like, shape $(k,k,m)$

$r[i-1,j-1,l-1]$ must contain the $(i,j)$th element of the sample cross-correlation at lag $l$, ${\hat{R}}_{\text{i}\text{j}}\left(\text{l}\right)$, for $\text{j}=1,2,\dots ,k$, for $\text{i}=1,2,\dots ,k$, for $\text{l}=1,2,\dots ,m$, where series $\text{j}$ leads series $\text{i}$ (see Further Comments).

Returns

maxlagint

The maximum lag up to which partial lag correlation matrices (along with ${\chi }^2$-statistics and their significance levels) have been successfully computed. On a successful exit $maxlag$ will equal $\text{m}$. If $errno$ = 2 on exit, $maxlag$ will be less than $\text{m}$.

parlagfloat, ndarray, shape $(k,k,m)$

$parlag[i-1,j-1,l-1]$ contains the $(i,j)$th element of the sample partial lag correlation matrix at lag $l$, ${\hat{P}}_{\text{i}\text{j}}\left(\text{l}\right)$, for $\text{j}=1,2,\dots ,k$, for $\text{i}=1,2,\dots ,k$, for $\text{l}=1,2,\dots ,maxlag$.

xfloat, ndarray, shape $\left(m\right)$

$x[\text{l}-1]$ contains the ${\chi }^2$-statistic at lag $\text{l}$, for $\text{l}=1,2,\dots ,maxlag$.

pvaluefloat, ndarray, shape $\left(m\right)$

$pvalue[\text{l}-1]$ contains the significance level of the corresponding ${\chi }^2$-statistic in $x$, for $\text{l}=1,2,\dots ,maxlag$.

Raises

NagValueError

(errno $1$)

On entry, $m=⟨value⟩$ and $n=⟨value⟩$.

Constraint: $m<n$.

(errno $1$)

On entry, $m=⟨value⟩$.

Constraint: $m\ge 1$.

(errno $1$)

On entry, $n=⟨value⟩$.

Constraint: $n\ge 2$.

(errno $1$)

On entry, $k=⟨value⟩$.

Constraint: $k\ge 1$.

Warns

NagAlgorithmicWarning

(errno $2$)

The recursive equations used to compute the partial lag correlation matrices are ill-conditioned (they have been computed up to lag $⟨value⟩$).

Notes

Let $W_{\text{t}}={(w_{1\text{t}},w_{2\text{t}},\dots ,w_{\text{k}\text{t}})}^T$, for $\text{t}=1,2,\dots ,n$, denote $n$ observations of a vector of $k$ time series. The partial lag correlation matrix at lag $l$, $P\left(l\right)$, is defined to be the correlation matrix between $W_t$ and $W_{t+l}$, after removing the linear dependence on each of the intervening vectors $W_{t+1},W_{t+2},\dots ,W_{t+l-1}$. It is the correlation matrix between the residual vectors resulting from the regression of $W_{t+l}$ on the carriers $W_{t+l-1},\dots ,W_{t+1}$ and the regression of $W_t$ on the same set of carriers; see Heyse and Wei (1985).

$P\left(l\right)$ has the following properties.

1. If $W_t$ follows a vector autoregressive model of order $p$, then $P\left(l\right)=0$ for $l>p$;

2. When $k=1$, $P\left(l\right)$ reduces to the univariate partial autocorrelation at lag $l$;

3. Each element of $P\left(l\right)$ is a properly normalized correlation coefficient;

4. When $l=1$, $P\left(l\right)$ is equal to the cross-correlation matrix at lag $1$ (a natural property which also holds for the univariate partial autocorrelation function).

Sample estimates of the partial lag correlation matrices may be obtained using the recursive algorithm described in Wei (1990). They are calculated up to lag $m$, which is usually taken to be at most $n/4$. Only the sample cross-correlation matrices ( $\hat{R}\left(\text{l}\right)$, for $\text{l}=0,1,\dots ,m$) and the standard deviations of the series are required as input to multi_corrmat_partlag. These may be computed by multi_corrmat_cross(). Under the hypothesis that $W_t$ follows an autoregressive model of order $s-1$, the elements of the sample partial lag matrix $\hat{P}\left(s\right)$, denoted by ${\hat{P}}_{ij}\left(s\right)$, are asymptotically Normally distributed with mean zero and variance $1/n$. In addition the statistic

$$X\left(s\right)=n\sum _{i=1}^k\sum _{j=1}^k{\hat{P}}_{ij}{\left(s\right)}^2$$

has an asymptotic ${\chi }^2$-distribution with $k^2$ degrees of freedom. These quantities, $X\left(l\right)$, are useful as a diagnostic aid for determining whether the series follows an autoregressive model and, if so, of what order.

References

Heyse, J F and Wei, W W S, 1985, The partial lag autocorrelation function, Technical Report No. 32, Department of Statistics, Temple University, Philadelphia

Wei, W W S, 1990, Time Series Analysis: Univariate and Multivariate Methods, Addison–Wesley