LSBlackBoxEvaluationPoint (LocalSolver 11.0 API)

java.lang.Object
- localsolver.LSBlackBoxEvaluationPoint

```
public class LSBlackBoxEvaluationPoint
extends java.lang.Object
```
An evaluation point associated with a black-box function. 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 Also:

LSBlackBoxContext.createEvaluationPoint(), LSBlackBoxContext.getEvaluationPoint(int pos)

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addArgument(double value)` Adds a double argument with the given value.
`void`	`addArgument(long value)` Adds an integer argument with the given value.
`boolean`	`equals(java.lang.Object obj)`
`LSArray`	`getArrayReturnValue()` Returns the return value of this evaluation point.
`double`	`getDoubleArgument(int pos)` Returns the value of the argument at the given position.
`double`	`getDoubleReturnValue()` Returns the return value of this evaluation point.
`long`	`getIntArgument(int pos)` Returns the value of the argument at the given position.
`long`	`getIntReturnValue()` Returns the return value of this evaluation point.
`int`	`hashCode()`
`boolean`	`isArrayReturnValue()` Returns true if the black-box function associated with this evaluation point is an array function, false otherwise.
`boolean`	`isDoubleArgument(int pos)` Returns true if the argument at this given position is a double, false otherwise.
`boolean`	`isDoubleReturnValue()` Returns true if the black-box function associated with this evaluation point is a double function, false otherwise.
`boolean`	`isIntArgument(int pos)` Returns true if the argument at this given position is an integer, false otherwise.
`boolean`	`isIntReturnValue()` Returns true if the black-box function associated with this evaluation point is an integer function, false otherwise.
`void`	`setArgument(int pos, double value)` Sets the value of the argument at the given position.
`void`	`setArgument(int pos, long value)` Sets the value of the argument at the given position.
`void`	`setReturnValue(double value)` Sets the return value of this evaluation point.
`void`	`setReturnValue(double[] value)` Sets the return value of this evaluation point.
`void`	`setReturnValue(long value)` Sets the return value of this evaluation point.
`void`	`setReturnValue(long[] value)` Sets the return value of this evaluation point.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - addArgument
```
public void addArgument(long value)
```
    Adds an integer argument with the given value. Only allowed if the associated decision variable is an integer or a boolean. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    value - Value of the argument.
  - addArgument
```
public void addArgument(double value)
```
    Adds a double argument with the given value. Only allowed if the associated decision variable is a double. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    value - Value of the argument.
  - setArgument
```
public void setArgument(int pos,
                        long value)
```
    Sets the value of the argument at the given position. Only allowed if this argument is an integer or a boolean. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    pos - Position in the argument list.
    
    value - Value of the argument.
  - setArgument
```
public void setArgument(int pos,
                        double value)
```
    Sets the value of the argument at the given position. Only allowed if this argument is a double. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    pos - Position in the argument list.
    
    value - Value of the argument.
  - setReturnValue
```
public void setReturnValue(long value)
```
    Sets the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is an integer function. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    value - Return value of this point.
  - setReturnValue
```
public void setReturnValue(double value)
```
    Sets the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is a double function. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    value - Return value of this point.
  - setReturnValue
```
public void setReturnValue(long[] value)
```
    Sets the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is an integer array function. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    value - Return value of this point.
  - setReturnValue
```
public void setReturnValue(double[] value)
```
    Sets the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is a double array function. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    value - Return value of this point.
  - isIntReturnValue
```
public boolean isIntReturnValue()
```
    Returns true if the black-box function associated with this evaluation point is an integer function, false otherwise. You can retrieve the value with getIntReturnValue(). Only allowed in state LSState.Stopped.
    
    Returns:
    
    True if the return value is an integer.
  - isDoubleReturnValue
```
public boolean isDoubleReturnValue()
```
    Returns true if the black-box function associated with this evaluation point is a double function, false otherwise. You can retrieve the value with getDoubleReturnValue(). Only allowed in state LSState.Stopped.
    
    Returns:
    
    True if the return value is a double.
  - isArrayReturnValue
```
public boolean isArrayReturnValue()
```
    Returns true if the black-box function associated with this evaluation point is an array function, false otherwise. You can retrieve the value with getArrayReturnValue(). Only allowed in state LSState.Stopped.
    
    Returns:
    
    True if the return value is an array.
  - isIntArgument
```
public boolean isIntArgument(int pos)
```
    Returns true if the argument at this given position is an integer, false otherwise. You can retrieve the value with getIntArgument(int). Only allowed in state LSState.Stopped.
    
    Parameters:
    
    pos - Position in the argument list.
    
    Returns:
    
    True if the argument at this given position is an integer.
  - isDoubleArgument
```
public boolean isDoubleArgument(int pos)
```
    Returns true if the argument at this given position is a double, false otherwise. You can retrieve the value with getDoubleArgument(int). Only allowed in state LSState.Stopped.
    
    Parameters:
    
    pos - Position in the argument list.
    
    Returns:
    
    True if the argument at this given position is a double.
  - getIntReturnValue
```
public long getIntReturnValue()
```
    Returns the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is an integer function. Only allowed in state LSState.Stopped.
    
    Returns:
    
    Return value of this point.
  - getDoubleReturnValue
```
public double getDoubleReturnValue()
```
    Returns the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is a double function. Only allowed in state LSState.Stopped.
    
    Returns:
    
    Return value of this point.
  - getArrayReturnValue
```
public LSArray getArrayReturnValue()
```
    Returns the return value of this evaluation point. Only allowed if the black-box function associated with this evaluation point is an array function. Only allowed in state LSState.Stopped.
    
    Returns:
    
    Return value of this point.
  - getIntArgument
```
public long getIntArgument(int pos)
```
    Returns the value of the argument at the given position. Only allowed if this argument is an integer or a boolean. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    pos - Position in the argument list.
    
    Returns:
    
    Value of the argument.
  - getDoubleArgument
```
public double getDoubleArgument(int pos)
```
    Returns the value of the argument at the given position. Only allowed if this argument is a double. Only allowed in state LSState.Stopped.
    
    Parameters:
    
    pos - Position in the argument list.
    
    Returns:
    
    Value of the argument.
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object

Class LSBlackBoxEvaluationPoint

Method Summary

Methods inherited from class java.lang.Object

Method Detail

addArgument

addArgument

setArgument

setArgument

setReturnValue

setReturnValue

setReturnValue

setReturnValue

isIntReturnValue

isDoubleReturnValue

isArrayReturnValue

isIntArgument

isDoubleArgument

getIntReturnValue

getDoubleReturnValue

getArrayReturnValue

getIntArgument

getDoubleArgument

hashCode

equals