g13asf is a diagnostic checking routine suitable for use after fitting a Box–Jenkins ARMA model to a univariate time series using g13aef or g13aff. The residual autocorrelation function is returned along with an estimate of its asymptotic standard errors and correlations. Also, g13asf calculates the Box–Ljung portmanteau statistic and its significance level for testing model adequacy.

2 Specification

Fortran Interface

Subroutine g13asf (

n, v, mr, m, par, npar, ishow, r, rcm, ldrcm, chi, idf, siglev, iw, liw, work, lwork, ifail)

Integer, Intent (In)	::	n, mr(7), m, npar, ishow, ldrcm, liw, lwork
Integer, Intent (Inout)	::	ifail
Integer, Intent (Out)	::	idf, iw(liw)
Real (Kind=nag_wp), Intent (In)	::	v(n), par(npar)
Real (Kind=nag_wp), Intent (Inout)	::	rcm(ldrcm,m)
Real (Kind=nag_wp), Intent (Out)	::	r(m), chi, siglev, work(lwork)

C Header Interface

#include <nag.h>

void

g13asf_ (const Integer *n, const double v[], const Integer mr[], const Integer *m, const double par[], const Integer *npar, const Integer *ishow, double r[], double rcm[], const Integer *ldrcm, double *chi, Integer *idf, double *siglev, Integer iw[], const Integer *liw, double work[], const Integer *lwork, Integer *ifail)

The routine may be called by the names g13asf or nagf_tsa_uni_arima_resid.

3 Description

Consider the univariate multiplicative autoregressive-moving average model

ϕ (B) Φ (B^{s}) (W_{t} - μ) = θ (B) Θ (B^{s}) ε_{t}

(1)

where

W_{t}

, for

t = 1, 2, \dots, n

, denotes a time series and

ε_{t}

, for

t = 1, 2, \dots, n

, is a residual series assumed to be normally distributed with zero mean and variance

σ^{2}

(

> 0

). The

ε_{t}

's are also assumed to be uncorrelated. Here

μ

is the overall mean term,

s

is the seasonal period and

B

is the backward shift operator such that

B^{r} W_{t} = W_{t - r}

. The polynomials in (1) are defined as follows:

ϕ (B) = 1 - ϕ_{1} B - ϕ_{2} B^{2} - \dots - ϕ_{p} B^{p}

is the non-seasonal autoregressive (AR) operator;

θ (B) = 1 - θ_{1} B - θ_{2} B^{2} - \dots - θ_{q} B^{q}

is the non-seasonal moving average (MA) operator;

Φ (B^{s}) = 1 - Φ_{1} B^{s} - Φ_{2} B^{2 s} - \dots - Φ_{P} B^{P s}

is the seasonal AR operator; and

Θ (B^{s}) = 1 - Θ_{1} B^{s} - Θ_{2} B^{2 s} - \dots - Θ_{Q} B^{Q s}

is the seasonal MA operator. The model (1) is assumed to be stationary, that is the zeros of

ϕ (B)

and

Φ (B^{s})

are assumed to lie outside the unit circle. The model (1) is also assumed to be invertible, that is the zeros of

θ (B)

and

Θ (B^{s})

are assumed to lie outside the unit circle. When both

Φ (B^{s})

and

Θ (B^{s})

are absent from the model, that is when

P = Q = 0

, then the model is said to be non-seasonal.

The estimated residual autocorrelation coefficient at lag

l

{\hat{r}}_{l}

, is computed as:

{\hat{r}}_{l} = \frac{\sum_{t = l + 1}^{n} ({\hat{ε}}_{t - l} - \bar{ε}) ({\hat{ε}}_{t} - \bar{ε})}{\sum_{t = 1}^{n} {({\hat{ε}}_{t} - \bar{ε})}^{2}}, l = 1, 2, \dots

where

{\hat{ε}}_{t}

denotes an estimate of the

t

th residual,

ε_{t}

, and

\bar{ε} = \sum_{t = 1}^{n} {\hat{ε}}_{t} / n

. A portmanteau statistic,

Q_{(m)}

, is calculated from the formula (see Box and Ljung (1978)):

Q_{(m)} = n (n + 2) \sum_{l = 1}^{m} {\hat{r}}_{l}^{2} / (n - l)

where

m

denotes the number of residual autocorrelations computed. (Advice on the choice of

m

is given in Section 9.2.) Under the hypothesis of model adequacy,

Q_{(m)}

has an asymptotic

χ^{2}

-distribution on

m - p - q - P - Q

degrees of freedom. Let

{\hat{r}}^{T} = ({\hat{r}}_{1}, {\hat{r}}_{2}, \dots, {\hat{r}}_{m})

then the variance-covariance matrix of

\hat{r}

is given by:

Var (\hat{r}) = [I_{m} - X {(X^{T} X)}^{- 1} X^{T}] / n .

The construction of the matrix

X

is discussed in McLeod (1978). (Note that the mean,

μ

, and the residual variance,

σ^{2}

, play no part in calculating

Var (\hat{r})

and therefore are not required as input to g13asf.)

Note: for additive models with fixed parameter values (i.e., fitted by g13ddf) g13dsf should be used instead of g13asf.

4 References

Box G E P and Ljung G M (1978) On a measure of lack of fit in time series models Biometrika 65 297–303

McLeod A I (1978) On the distribution of the residual autocorrelations in Box–Jenkins models J. Roy. Statist. Soc. Ser. B 40 296–302

5 Arguments

1: $n$ – Integer Input

On entry:

n

, the number of observations in the residual series.

If g13asf is used following a call to g13aef, then n must be the value

icount (2)

returned by g13aef.

If g13asf is used following a call to g13aff, then n must be the value nres returned by g13aff.

Constraint:

n \geq 3

2: $v (n)$ – Real (Kind=nag_wp) array Input

On entry:

v (t)

must contain an estimate of

ε_{t}

, for

t = 1, 2, \dots, n

If g13asf is used following a call to g13aef then the actual argument v must be

exr (icount (1) + 1)

as returned by g13aef.

If g13asf is used following a call to g13aff then the actual argument v must be res as returned by g13aff.

Constraint:

v

must contain at least two distinct elements.

3: $mr (7)$ – Integer array Input

On entry: the orders vector (

p

d

q

P

D

Q

s

) as supplied to g13aef or g13aff.

Constraints:

$p, q, P, Q, s \geq 0$ ;
$p + q + P + Q > 0$ ;
if $s = 0$ , then $P = 0$ and $Q = 0$ .

4: $m$ – Integer Input

On entry: the value of

m

, the number of residual autocorrelations to be computed. See Section 9.2 for advice on the value of m.

Constraint:

npar < m < n

5: $par (npar)$ – Real (Kind=nag_wp) array Input

On entry: the parameter estimates in the order

ϕ_{1}, ϕ_{2}, \dots, ϕ_{p}

θ_{1}, θ_{2}, \dots, θ_{q}

Φ_{1}, Φ_{2}, \dots, Φ_{P}

Θ_{1}, Θ_{2}, \dots, Θ_{Q}

only.

Constraint: the elements in par must satisfy the stationarity and invertibility conditions.

6: $npar$ – Integer Input

On entry: the total number of

ϕ

θ

Φ

and

Θ

parameters, i.e.,

npar = p + q + P + Q

Constraint:

npar = mr (1) + mr (3) + mr (4) + mr (6)

7: $ishow$ – Integer Input

On entry: must be nonzero if the residual autocorrelations, their standard errors and the portmanteau statistics are to be printed and zero otherwise.

These quantities are available also as output variables in r, rcm, chi, idf and siglev.

8: $r (m)$ – Real (Kind=nag_wp) array Output

On exit: an estimate of the residual autocorrelation coefficient at lag

l

, for

l = 1, 2, \dots, m

. If

ifail = 3

on exit then all elements of r are set to zero.

9: $rcm (ldrcm, m)$ – Real (Kind=nag_wp) array Output

On exit: the estimated standard errors and correlations of the elements in the array r. The correlation between

r (i)

and

r (j)

is returned as

rcm (i, j)

except that if

i = j

then

rcm (i, j)

contains the standard error of

r (i)

. If on exit,

ifail \geq 5

, then all off-diagonal elements of rcm are set to zero and all diagonal elements are set to

1 / \sqrt{n}

10: $ldrcm$ – Integer Input

On entry: the first dimension of the array rcm as declared in the (sub)program from which g13asf is called.

Constraint:

ldrcm \geq m

11: $chi$ – Real (Kind=nag_wp) Output

On exit: the value of the portmanteau statistic,

Q_{(m)}

. If

ifail = 3

on exit then chi is returned as zero.

12: $idf$ – Integer Output

On exit: the number of degrees of freedom of chi.

13: $siglev$ – Real (Kind=nag_wp) Output

On exit: the significance level of chi based on idf degrees of freedom. If

ifail = 3

on exit, siglev is returned as one.

14: $iw (liw)$ – Integer array Workspace

15: $liw$ – Integer Input

On entry: the dimension of the array iw as declared in the (sub)program from which g13asf is called.

Constraint:

liw \geq \max (mr (1), mr (3), mr (4), mr (6))

16: $work (lwork)$ – Real (Kind=nag_wp) array Workspace

17: $lwork$ – Integer Input

On entry: the dimension of the array work as declared in the (sub)program from which g13asf is called.

Constraint:

lwork \geq npar \times (m + npar + 1) + \max (mr (1), mr (3), mr (4), mr (6)) \times \max (mr (7), 1) + m

18: $ifail$ – Integer Input/Output

On entry: ifail must be set to

0

- 1

1

to set behaviour on detection of an error; these values have no effect when no error is detected.

A value of

0

causes the printing of an error message and program execution will be halted; otherwise program execution continues. A value of

- 1

means that an error message is printed while a value of

1

means that it is not.

If halting is not appropriate, the value

- 1

1

is recommended. If message printing is undesirable, then the value

1

is recommended. Otherwise, the value

- 1

is recommended since useful values can be provided in some output arguments even when

ifail \neq 0

on exit. When the value $- 1$ or $1$ is used it is essential to test the value of ifail on exit.

On exit:

ifail = 0

unless the routine detects an error or a warning has been flagged (see Section 6).

6 Error Indicators and Warnings

If on entry

ifail = 0

- 1

, explanatory error messages are output on the current error message unit (as defined by x04aaf).

Errors or warnings detected by the routine:

Note: in some cases g13asf may return useful information.

$ifail = 1$: On entry, $ldrcm = 〈value〉$ and $m = 〈value〉$ .
Constraint: $ldrcm \geq m$ .

On entry, $liw = 〈value〉$ and the minimum size $required = 〈value〉$
Constraint: $liw \geq \max (p, q, P, Q)$ .

On entry, $lwork = 〈value〉$ and the minimum size $required = 〈value〉$ .
Constraint: $lwork \geq npar \times (m + npar + 1) + \max (p, q, P, Q) \times \max (s, 1) + m$ .

On entry, $m = 〈value〉$ and $n = 〈value〉$ .
Constraint: $m < n$ .

On entry, $m = 〈value〉$ and $npar = 〈value〉$ .
Constraint: $m > npar$ .

On entry, $mr (1) = 〈value〉$ .
Constraint: $mr (1) \geq 0$ .

On entry, $mr (3) = 〈value〉$ .
Constraint: $mr (3) \geq 0$ .

On entry, $mr (4) = 〈value〉$ .
Constraint: $mr (4) \geq 0$ .

On entry, $mr (4) = 〈value〉$ and $mr (6) = 〈value〉$ .
Constraint: $mr (4) = 0$ and $mr (6) = 0$ .

On entry, $mr (6) = 〈value〉$ .
Constraint: $mr (6) \geq 0$ .

On entry, $mr (7) = 〈value〉$ .
Constraint: $mr (7) \geq 0$ .

On entry, $npar = 〈value〉$ .
Constraint: $npar \neq 0$ and $npar = p + q + P + Q$ .

$ifail = 2$: On entry, the non-seasonal autoregressive operator is nonstationary. To proceed you must supply different parameter estimates in the array par.

On entry, the non-seasonal moving average operator is non-invertible. To proceed you must supply different parameter estimates in the array par.

On entry, the seasonal autoregressive operator is nonstationary. To proceed you must supply different parameter estimates in the array par.

On entry, the seasonal moving average operator is non-invertible. To proceed you must supply different parameter estimates in the array par.

$ifail = 3$: On entry, the elements of v are nearly identical giving near-zero variance. In this case chi is set to zero and siglev to one and all the elements of r are set to zero.

$ifail = 4$: Excessive iterations needed to find zeros of determinental polynomials.

$ifail = 5$: On entry, one or more of the AR operators has a factor in common with one or more of the MA operators. To proceed this common factor must be deleted from the model. In this case, the off-diagonal elements of rcm are returned as zero and the diagonal elements are set to $1 / \sqrt{n}$ . All other output quantities will be correct.

$ifail = 6$: The matrix rcm could not be computed because one of its diagonal elements was found to be non-positive. In this case, the off-diagonal elements of rcm are returned as zero and the diagonal elements set to $1 / \sqrt{n}$ .

$ifail = - 99$: An unexpected error has been triggered by this routine. Please contact NAG.
See Section 7 in the Introduction to the NAG Library FL Interface for further information.

$ifail = - 399$: Your licence key may have expired or may not have been installed correctly.
See Section 8 in the Introduction to the NAG Library FL Interface for further information.

$ifail = - 999$: Dynamic memory allocation failed.
See Section 9 in the Introduction to the NAG Library FL Interface for further information.

7 Accuracy

The computations are believed to be stable.

8 Parallelism and Performance

g13asf is threaded by NAG for parallel execution in multithreaded implementations of the NAG Library.

g13asf makes calls to BLAS and/or LAPACK routines, which may be threaded within the vendor library used by this implementation. Consult the documentation for the vendor library for further information.

Please consult the X06 Chapter Introduction for information on how to control and interrogate the OpenMP environment used within this routine. Please also consult the Users' Note for your implementation for any additional implementation-specific information.

9 Further Comments

9.1 Timing

The time taken by g13asf depends upon the number of residual autocorrelations to be computed,

m

9.2 Choice of $m$

The number of residual autocorrelations to be computed,

m

should be chosen to ensure that when the ARMA model (1) is written as either an infinite order autoregressive process:

W_{t} - μ = \sum_{j = 1}^{\infty} π_{j} (W_{t - j} - μ) + ε_{t}

or as an infinite order moving average process:

W_{t} - μ = \sum_{j = 1}^{\infty} ψ_{j} ε_{t - j} + ε_{t}

then the two sequences

\{π_{1}, π_{2}, \dots\}

and

\{ψ_{1}, ψ_{2}, \dots\}

are such that

π_{j}

and

ψ_{j}

are approximately zero for

j > m

. An overestimate of

m

is therefore preferable to an under-estimate of

m

. In many instances the choice

m = 10

will suffice. In practice, to be on the safe side, you should try setting

m = 20

9.3 Approximate Standard Errors

When

ifail = 5

6

all the standard errors in rcm are set to

1 / \sqrt{n}

. This is the asymptotic standard error of

{\hat{r}}_{l}

when all the autoregressive and moving average parameters are assumed to be known rather than estimated.

9.4 Alternative Applications

g13asf may be used for diagnostic checking of suitable univariate ARMA models, as described in Section 3, fitted by g13bef or g13ddf. Great care must be taken in obtaining the input values for g13asf from the output values from g13bef or g13ddf.

10 Example

This example fits an ARIMA

(1, 1, 2)

model to a series of

30

observations.

10

residual autocorrelations are computed.

g13as: FL CL CPP AD

NAG FL Interfaceg13asf (uni_​arima_​resid)

▸▿ Contents

1 Purpose

2 Specification

3 Description

4 References

5 Arguments

6 Error Indicators and Warnings

7 Accuracy

8 Parallelism and Performance

9 Further Comments

9.1 Timing

9.2 Choice of m

9.3 Approximate Standard Errors

9.4 Alternative Applications

10 Example

10.1 Program Text

10.2 Program Data

10.3 Program Results

NAG FL Interface
g13asf (uni_arima_resid)

9.2 Choice of $m$