returnCode: Success or failure of the optimization
In maxLik: Maximum Likelihood Estimation and Related Tools

Description Usage Arguments Details Value Author(s) See Also Examples

These function extract success or failure information from optimization objects. The returnCode gives a numeric code, and returnMessage a brief description about the success or failure of the optimization, and point to the problems occured (see documentation for the corresponding functions).

returnCode(x, ...)
## Default S3 method:
returnCode(x, ...)
## S3 method for class 'maxLik'
returnCode(x, ...)
returnMessage(x, ...)
## S3 method for class 'maxim'
returnMessage(x, ...)
## S3 method for class 'maxLik'
returnMessage(x, ...)

`x`	object, usually an optimization result
`...`	further arguments for other methods

returnMessage and returnCode are a generic functions, with methods for various optimisation algorithms. The message should either describe the convergence (stopping condition), or the problem.

The known codes and the related messages are:

1 gradient close to zero (normal convergence).
2 successive function values within tolerance limit (normal convergence).
3 last step could not find higher value (probably not converged). This is related to line search step getting too small, usually because hitting the boundary of the parameter space. It may also be related to attempts to move to a wrong direction because of numerical errors. In some cases it can be helped by changing steptol.
4 iteration limit exceeded.
5 Infinite value.
6 Infinite gradient.
7 Infinite Hessian.
8Successive function values withing relative tolerance limit (normal convergence).
9 (BFGS) Hessian approximation cannot be improved because of gradient did not change. May be related to numerical approximation problems or wrong analytic gradient.
10 Lost patience: the optimizer has hit an inferior value too many times (see maxSGA for more information)
100 Initial value out of range.

Integer for returnCode, character for returnMessage. Different optimization routines may define it in a different way.

Ott Toomet

maxNR, maxBFGS

## maximise the exponential bell
f1 <- function(x) exp(-x^2)
a <- maxNR(f1, start=2)
returnCode(a) # should be success (1 or 2)
returnMessage(a)
## Now try to maximise log() function
a <- maxNR(log, start=2)
returnCode(a) # should give a failure (4)
returnMessage(a)

Loading required package: miscTools

Please cite the 'maxLik' package as:
Henningsen, Arne and Toomet, Ott (2011). maxLik: A package for maximum likelihood estimation in R. Computational Statistics 26(3), 443-458. DOI 10.1007/s00180-010-0217-1.

If you have questions, suggestions, or comments regarding the 'maxLik' package, please use a forum or 'tracker' at maxLik's R-Forge site:
https://r-forge.r-project.org/projects/maxlik/
[1] 1
[1] "gradient close to zero"
[1] 4
[1] "Iteration limit exceeded."