This page is for an old version of Hexaly Optimizer. We recommend that you update your version and read the documentation for the latest stable release.

LSEvaluationPoint Class

class localsolver.LSEvaluationPoint

An evaluation point associated with an external function with surrogate modeling.

Evaluation points are used to specify known points for a function in advance. It can be useful to warm-start the solver when the function is particularly expensive to evaluate, or if you already have a good estimate of the optimal point.

Note: This information is used by the solver to drive the solution process. You must be careful about the data you provide: if an incorrect value is given, the solver may have an unexpected behavior.

Since

10.0

See

LSSurrogateParameters.create_evaluation_point()

See

LSSurrogateParameters.get_evaluation_point()

Summary

Methods

add_argument

Adds an argument with the given value.

set_argument

Sets the value of the argument at the given position.

set_return_value

Sets the return value of this evaluation point.

get_return_value

Returns the return value of this evaluation point.

get_argument

Returns the value of the argument at the given position.

Instance methods

LSEvaluationPoint.add_argument(value)

Adds an argument with the given value. Only allowed in states MODELING or STOPPED.

Parameters

value (int or double) – Value of the argument.

LSEvaluationPoint.set_argument(pos, value)

Sets the value of the argument at the given position. Only allowed in states MODELING or STOPPED.

Parameters
  • pos – Position in the argument list.

  • value (int or double) – Value of the argument.

LSEvaluationPoint.set_return_value(value)

Sets the return value of this evaluation point. The type of the parameter value must be the same as the type of the external function associated with this evaluation point :

  • int for integer external function,

  • double for double external function,

  • an iterable (list, set, tuple) composed of numbers of same type (int or double) for array external function.

Only allowed in states MODELING or STOPPED.

Parameters

value (int, double or an iterable) – Return value of this point.

LSEvaluationPoint.get_return_value()

Returns the return value of this evaluation point. The returned value can be a double, an integer or LSArray depending on the type of the external function associated with this evaluation point.

Returns

Return value of this point.

Return type

int, double or LSArray

LSEvaluationPoint.get_argument(pos)

Returns the value of the argument at the given position. The returned value can be a double or an integer depending on the type of the argument value.

Parameters

pos – Position in the argument list.

Returns

Value of the argument.

Return type

int or double