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