NAG Library Routine Document

g13fef (uni_garch_gjr_estim)

1
Purpose

g13fef estimates the parameters of a univariate regression-GJR GARCHp,q process (see Glosten et al. (1993)).

2
Specification

Fortran Interface
Subroutine g13fef ( dist, yt, x, ldx, num, ip, iq, nreg, mn, npar, theta, se, sc, covr, ldcovr, hp, et, ht, lgf, copts, maxit, tol, work, lwork, ifail)
Integer, Intent (In):: ldx, num, ip, iq, nreg, mn, npar, ldcovr, maxit, lwork
Integer, Intent (Inout):: ifail
Real (Kind=nag_wp), Intent (In):: yt(num), x(ldx,*), tol
Real (Kind=nag_wp), Intent (Inout):: theta(npar), covr(ldcovr,npar), hp
Real (Kind=nag_wp), Intent (Out):: se(npar), sc(npar), et(num), ht(num), lgf, work(lwork)
Logical, Intent (In):: copts(2)
Character (1), Intent (In):: dist
C Header Interface
#include <nagmk26.h>
void  g13fef_ (const char *dist, const double yt[], const double x[], const Integer *ldx, const Integer *num, const Integer *ip, const Integer *iq, const Integer *nreg, const Integer *mn, const Integer *npar, double theta[], double se[], double sc[], double covr[], const Integer *ldcovr, double *hp, double et[], double ht[], double *lgf, const logical copts[], const Integer *maxit, const double *tol, double work[], const Integer *lwork, Integer *ifail, const Charlen length_dist)

3
Description

A univariate regression-GJR GARCHp,q process, with q coefficients αi, for i=1,2,,q, p coefficients βi, for i=1,2,,p, and k linear regression coefficients bi, for i=1,2,,k, can be represented by:
yt = bo + xtT b + εt (1)
ht = α0 + i=1 q αi + γ It-i ε t-i2 + i=1 p βi ht-i ,   t=1,2,,T (2)
where It=1, if εt<0, It=0, if εt0, and εtψt-1=N0,ht or εtψt-1=Stdf,ht. Here St is a standardized Student's t-distribution with df degrees of freedom and variance ht, T is the number of terms in the sequence, yt denotes the endogenous variables, xt the exogenous variables, bo the regression mean, b the regression coefficients, εt the residuals, ht is the conditional variance, and ψt the set of all information up to time t.
g13fef provides an estimate for θ^, the parameter vector θ=bo,bT,ωT where bT=b1,,bk, ωT=α0,α1,,αq,β1,,βp,γ when dist='N' and ωT=α0,α1,,αq,β1,,βp,γ,df when dist='T'.
mn, nreg can be used to simplify the GARCHp,q expression in (1) as follows:
No Regression and No Mean
No Regression
Note:  if the yt=μ+εt, where μ is known (not to be estimated by g13fef) then (1) can be written as ytμ=εt, where ytμ=yt-μ. This corresponds to the case No Regression and No Mean, with yt replaced by yt-μ.
No Mean

4
References

Bollerslev T (1986) Generalised autoregressive conditional heteroskedasticity Journal of Econometrics 31 307–327
Engle R (1982) Autoregressive conditional heteroskedasticity with estimates of the variance of United Kingdom inflation Econometrica 50 987–1008
Engle R and Ng V (1993) Measuring and testing the impact of news on volatility Journal of Finance 48 1749–1777
Glosten L, Jagannathan R and Runkle D (1993) Relationship between the expected value and the volatility of nominal excess return on stocks Journal of Finance 48 1779–1801
Hamilton J (1994) Time Series Analysis Princeton University Press

5
Arguments

1:     dist – Character(1)Input
On entry: the type of distribution to use for et.
dist='N'
A Normal distribution is used.
dist='T'
A Student's t-distribution is used.
Constraint: dist='N' or 'T'.
2:     ytnum – Real (Kind=nag_wp) arrayInput
On entry: the sequence of observations, yt, for t=1,2,,T.
3:     xldx* – Real (Kind=nag_wp) arrayInput
Note: the second dimension of the array x must be at least nreg.
On entry: row t of x must contain the time dependent exogenous vector xt , where xtT = xt1,,xtk , for t=1,2,,T.
4:     ldx – IntegerInput
On entry: the first dimension of the array x as declared in the (sub)program from which g13fef is called.
Constraint: ldxnum.
5:     num – IntegerInput
On entry: T, the number of terms in the sequence.
Constraints:
  • nummaxip,iq;
  • numnreg+mn.
6:     ip – IntegerInput
On entry: the number of coefficients, βi, for i=1,2,,p.
Constraint: ip0 (see also npar).
7:     iq – IntegerInput
On entry: the number of coefficients, αi, for i=1,2,,q.
Constraint: iq1 (see also npar).
8:     nreg – IntegerInput
On entry: k, the number of regression coefficients.
Constraint: nreg0 (see also npar).
9:     mn – IntegerInput
On entry: if mn=1, the mean term b0 will be included in the model.
Constraint: mn=0 or 1.
10:   npar – IntegerInput
On entry: the number of parameters to be included in the model. npar=2+iq+ip+mn+nreg when dist='N' and npar=3+iq+ip+mn+nreg when dist='T'.
Constraint: npar<20.
11:   thetanpar – Real (Kind=nag_wp) arrayInput/Output
On entry: the initial parameter estimates for the vector θ.
The first element must contain the coefficient αo and the next iq elements contain the coefficients αi, for i=1,2,,q.
The next ip elements must contain the coefficients βj, for j=1,2,,p.
The next element must contain the asymmetry parameter γ.
If dist='T', the next element contains df, the number of degrees of freedom of the Student's t-distribution.
If mn=1, the next element must contain the mean term bo.
If copts2=.FALSE., the remaining nreg elements are taken as initial estimates of the linear regression coefficients bi, for i=1,2,,k.
On exit: the estimated values θ^ for the vector θ.
The first element contains the coefficient αo, the next iq elements contain the coefficients αi, for i=1,2,,q.
The next ip elements are the moving average coefficients βj, for j=1,2,,p.
The next element contains the estimate for the asymmetry parameter γ.
If dist='T', the next element contains an estimate for df, the number of degrees of freedom of the Student's t-distribution.
If mn=1, the next element contains an estimate for the mean term bo.
The final nreg elements are the estimated linear regression coefficients bi, for i=1,2,,k.
12:   senpar – Real (Kind=nag_wp) arrayOutput
On exit: the standard errors for θ^.
The first element contains the standard error for αo and the next iq elements contain the standard errors for αi, for i=1,2,,q.
The next ip elements are the standard errors for βj, for j=1,2,,p.
The next element contains the standard error for γ.
If dist='T', the next element contains the standard error for df, the number of degrees of freedom of the Student's t-distribution.
If mn=1, the next element contains the standard error for bo.
The final nreg elements are the standard errors for bj, for j=1,2,,k.
13:   scnpar – Real (Kind=nag_wp) arrayOutput
On exit: the scores for θ^.
The first element contains the score for αo, the next iq elements contain the scores for αi, for i=1,2,,q.
The next ip elements are the score for βj, for j=1,2,,p.
The next element contains the score for γ.
If dist='T', the next element contains the score for df, the number of degrees of freedom of the Student's t-distribution.
If mn=1, the next element contains the score for bo.
The final nreg elements are the scores for bj, for j=1,2,,k.
14:   covrldcovrnpar – Real (Kind=nag_wp) arrayOutput
On exit: the covariance matrix of the parameter estimates θ^, that is the inverse of the Fisher Information Matrix.
15:   ldcovr – IntegerInput
On entry: the first dimension of the array covr as declared in the (sub)program from which g13fef is called.
Constraint: ldcovrnpar.
16:   hp – Real (Kind=nag_wp)Input/Output
On entry: if copts2=.FALSE., hp is the value to be used for the pre-observed conditional variance; otherwise hp is not referenced.
On exit: if copts2=.TRUE., hp is the estimated value of the pre-observed conditional variance.
17:   etnum – Real (Kind=nag_wp) arrayOutput
On exit: the estimated residuals, εt, for t=1,2,,T.
18:   htnum – Real (Kind=nag_wp) arrayOutput
On exit: the estimated conditional variances, ht, for t=1,2,,T.
19:   lgf – Real (Kind=nag_wp)Output
On exit: the value of the log-likelihood function at θ^.
20:   copts2 – Logical arrayInput
On entry: the options to be used by g13fef.
copts1=.TRUE.
Stationary conditions are enforced, otherwise they are not.
copts2=.TRUE.
The routine provides initial parameter estimates of the regression terms, otherwise these are to be provided by you.
21:   maxit – IntegerInput
On entry: the maximum number of iterations to be used by the optimization routine when estimating the GARCHp,q parameters. If maxit is set to 0, the standard errors, score vector and variance-covariance are calculated for the input value of θ in theta when dist='N'; however the value of θ is not updated.
Constraint: maxit0.
22:   tol – Real (Kind=nag_wp)Input
On entry: the tolerance to be used by the optimization routine when estimating the GARCHp,q parameters.
23:   worklwork – Real (Kind=nag_wp) arrayWorkspace
24:   lwork – IntegerInput
On entry: the dimension of the array work as declared in the (sub)program from which g13fef is called.
Constraint: lworknreg+3×num+npar+403.
25:   ifail – IntegerInput/Output
On entry: ifail must be set to 0, -1 or 1. If you are unfamiliar with this argument you should refer to Section 3.4 in How to Use the NAG Library and its Documentation for details.
For environments where it might be inappropriate to halt program execution when an error is detected, the value -1 or 1 is recommended. If the output of error messages is undesirable, then the value 1 is recommended. Otherwise, because for this routine the values of the output arguments may be useful even if ifail0 on exit, the recommended value is -1. 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 or -1, explanatory error messages are output on the current error message unit (as defined by x04aaf).
Note: g13fef may return useful information for one or more of the following detected errors or warnings.
Errors or warnings detected by the routine:
ifail=1
On entry, dist=value.
Constraint: dist='N' or 'T'.
On entry, ip=value.
Constraint: ip0.
On entry, iq=value.
Constraint: iq1.
On entry, ldcovr=value.
Constraint: ldcovrnpar.
On entry, ldx=value.
Constraint: ldxnum.
On entry, maxit=value.
Constraint: maxit0.
On entry, mn=value.
Constraint: mn=0 or 1.
On entry, npar=value.
Constraint: if dist='N' then npar=2+iq+ip+mn+nreg, else npar=3+iq+ip+mn+nreg.
On entry, npar=value.
Constraint: npar<20.
On entry, nreg=value.
Constraint: nreg0.
On entry, num=value.
Constraint: maxip,iqnum.
On entry, num=value.
Constraint: numnreg+mn.
ifail=2
On entry, lwork=value.
Constraint: lworknreg+3×num+npar+403.
ifail=3
On entry, the matrix X is not full rank.
ifail=4
The information matrix is not positive definite.
ifail=5
The maximum number of iterations has been reached.
ifail=6
The log-likelihood cannot be optimized any further.
ifail=7
No feasible model parameters could be found.
ifail=-99
An unexpected error has been triggered by this routine. Please contact NAG.
See Section 3.9 in How to Use the NAG Library and its Documentation for further information.
ifail=-399
Your licence key may have expired or may not have been installed correctly.
See Section 3.8 in How to Use the NAG Library and its Documentation for further information.
ifail=-999
Dynamic memory allocation failed.
See Section 3.7 in How to Use the NAG Library and its Documentation for further information.

7
Accuracy

Not applicable.

8
Parallelism and Performance

g13fef is threaded by NAG for parallel execution in multithreaded implementations of the NAG Library.
g13fef 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

None.

10
Example

This example fits a GARCH1,1 model with Student's t-distributed residuals to some simulated data.
The process parameter estimates, θ^, are obtained using g13fef, and a four step ahead volatility estimate is computed using g13fff.
The data was simulated using g05pff.

10.1
Program Text

Program Text (g13fefe.f90)

10.2
Program Data

Program Data (g13fefe.d)

10.3
Program Results

Program Results (g13fefe.r)