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