# naginterfaces.library.tsa.uni_​garch_​exp_​estim¶

naginterfaces.library.tsa.uni_garch_exp_estim(dist, yt, x, ip, iq, mn, theta, pht, copts, maxit, tol, io_manager=None)[source]

uni_garch_exp_estim estimates the parameters of a univariate regression-exponential process (see Engle and Ng (1993)).

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

https://www.nag.com/numeric/nl/nagdoc_27.1/flhtml/g13/g13fgf.html

Parameters
diststr, length 1

The type of distribution to use for .

A Normal distribution is used.

A Student’s -distribution is used.

ytfloat, array-like, shape

The sequence of observations, , for .

xfloat, array-like, shape

Row of must contain the time dependent exogenous vector , where , for .

ipint

The number of coefficients, , for .

iqint

The number of coefficients, , for .

mnint

If , the mean term will be included in the model.

thetafloat, array-like, shape

The initial parameter estimates for the vector .

The first element must contain the coefficient and the next elements must contain the autoregressive coefficients , for .

The next elements contain the coefficients , for .

The next elements must contain the moving average coefficients , for .

If , the next element must contain an estimate for , the number of degrees of freedom of the Student’s -distribution.

If , the next element must contain the mean term .

If , the remaining elements are taken as initial estimates of the linear regression coefficients , for .

phtfloat

If then is the value to be used for the pre-observed conditional variance, otherwise is not referenced.

coptsbool

If , the function provides initial parameter estimates of the regression terms, otherwise these are provided by you.

maxitint

The maximum number of iterations to be used by the optimization function when estimating the parameters.

tolfloat

The tolerance to be used by the optimization function when estimating the parameters.

io_managerFileObjManager, optional

Manager for I/O in this routine.

Returns
thetafloat, ndarray, shape

The estimated values for the vector .

The first element contains the coefficient and the next elements contain the coefficients , for .

The next elements contain the coefficients , for .

The next elements are the moving average coefficients , for .

If , the next element contains an estimate for then the number of degrees of freedom of the Student’s -distribution.

If , the next element contains an estimate for the mean term .

The final elements are the estimated linear regression coefficients , for .

sefloat, ndarray, shape

The standard errors for .

The first element contains the standard error for and the next elements contain the standard errors for , for .

The next elements contain the standard errors for , for .

The next elements are the standard errors for , for .

If , the next element contains the standard error for , the number of degrees of freedom of the Student’s -distribution.

If , the next element contains the standard error for .

The final elements are the standard errors for , for .

scfloat, ndarray, shape

The scores for .

The first element contains the scores for , the next elements contain the scores for , for , the next elements contain the scores for , for , the next elements are the scores for , for .

If , the next element contains the scores for , the number of degrees of freedom of the Student’s -distribution.

If , the next element contains the score for .

The final elements are the scores for , for .

covrfloat, ndarray, shape

The covariance matrix of the parameter estimates , that is the inverse of the Fisher Information Matrix.

phtfloat

If then is the estimated value of the pre-observed conditional variance.

etfloat, ndarray, shape

The estimated residuals, , for .

htfloat, ndarray, shape

The estimated conditional variances, , for .

lgffloat

The value of the log-likelihood function at .

Raises
NagValueError
(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: if then , else .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: or .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: or .

(errno )

On entry, .

Constraint: .

(errno )

On entry, the matrix is not full rank.

(errno )

The information matrix is not positive definite.

(errno )

No feasible model parameters could be found.

Warns
NagAlgorithmicWarning
(errno )

The maximum number of iterations has been reached.

(errno )

The log-likelihood cannot be optimized any further.

Notes

No equivalent traditional C interface for this routine exists in the NAG Library.

A univariate regression-exponential process, with coefficients , for , coefficients , for , coefficients, , for , and linear regression coefficients , for , can be represented by:

where , denotes the expected value of and or . Here is a standardized Student’s -distribution with degrees of freedom and variance , is the number of terms in the sequence, denotes the endogenous variables, the exogenous variables, the regression mean, the regression coefficients, the residuals, the conditional variance, the number of degrees of freedom of the Student’s -distribution, and the set of all information up to time .

uni_garch_exp_estim provides an estimate , for the vector where , when , and when .

, can be used to simplify the expression in (1) as follows:

No Regression and No Mean

,

,

and

is a vector when , and a vector, when .

No Regression

,

,

and

is a vector when and a vector, when .

Note: if the , where is known (not to be estimated by uni_garch_exp_estim) then (1) can be written as , where . This corresponds to the case No Regression and No Mean, with replaced by .

No Mean

,

,

and

is a vector when and a vector, when .

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