brown_al: Brown Almost-Linear Function

View source: R/27_brown_al.R

brown_alR Documentation

Brown Almost-Linear Function

Description

Test function 27 from the More', Garbow and Hillstrom paper.

Usage

brown_al()

Details

The objective function is the sum of m functions, each of n parameters.

  • Dimensions: Number of parameters n variable, number of summand functions m = n.

  • Minima: f = 0 at (a, a, a, ..., a ^ (1 - n)), where a satisfies n * a ^ n - (n + 1) * a ^ (n - 1) + 1 = 0; f = 1 at c(0, 0, ..., n + 1).

The number of parameters, n, in the objective function is not specified when invoking this function. It is implicitly set by the length of the parameter vector passed to the objective and gradient functions that this function creates. See the 'Examples' section.

Value

A list containing:

  • fn Objective function which calculates the value given input parameter vector.

  • gr Gradient function which calculates the gradient vector given input parameter vector.

  • he If available, the hessian matrix (second derivatives) of the function w.r.t. the parameters at the given values.

  • fg A function which, given the parameter vector, calculates both the objective value and gradient, returning a list with members fn and gr, respectively.

  • x0 Function returning the standard starting point, given n, the number of variables desired.

  • fmin reported minimum

  • xmin parameters at reported minimum

References

More', J. J., Garbow, B. S., & Hillstrom, K. E. (1981). Testing unconstrained optimization software. ACM Transactions on Mathematical Software (TOMS), 7(1), 17-41. \Sexpr[results=rd]{tools:::Rd_expr_doi("doi.org/10.1145/355934.355936")}

Brown, K. M. (1969). A quadratically convergent Newton-like method based upon Gaussian elimination. SIAM Journal on Numerical Analysis, 6(4), 560-569. \Sexpr[results=rd]{tools:::Rd_expr_doi("dx.doi.org/10.1137/0706051")}

Examples

bal <- brown_al()
# 6 variable problem using the standard starting point
x0_6 <- bal$x0(6)
res_6 <- stats::optim(x0_6, bal$fn, bal$gr, method = "L-BFGS-B")
# Standing starting point with 8 variables
res_8 <- stats::optim(bal$x0(8), bal$fn, bal$gr, method = "L-BFGS-B")
# Create your own 4 variable starting point
res_4 <- stats::optim(c(0.1, 0.2, 0.3, 0.4), bal$fn, bal$gr,
                      method = "L-BFGS-B")

jlmelville/funconstrain documentation built on April 17, 2024, 7:47 p.m.