Interface IMultiFidelityObjectEvaluator<T,​V extends java.lang.Comparable<V>>

  • Type Parameters:
    T - The type of object to be evaluated.
    V - The comparable evaluation value.
    All Superinterfaces:
    org.api4.java.common.attributedobjects.IGetter<T,​V>, org.api4.java.common.attributedobjects.IObjectEvaluator<T,​V>

    public interface IMultiFidelityObjectEvaluator<T,​V extends java.lang.Comparable<V>>
    extends org.api4.java.common.attributedobjects.IObjectEvaluator<T,​V>
    A multi-fidelity object evaluator allows for specifying a certain amount of an evaluation resource.
    • Method Detail

      • getMaxBudget

        double getMaxBudget()
        Returns:
        The maximum allocable budget.
      • getMinBudget

        double getMinBudget()
        Returns:
        The minimum allocable budget.
      • evaluate

        V evaluate​(T t,
                   double budget)
            throws java.lang.InterruptedException,
                   org.api4.java.common.attributedobjects.ObjectEvaluationFailedException
        Evaluate the object t with the specified budget.
        Parameters:
        t - The object to be evaluated.
        budget - The budget assigned for the evaluation of t.
        Returns:
        The evaluation score for the object t.
        Throws:
        java.lang.InterruptedException - Thrown if the evaluation routine is interrupted.
        org.api4.java.common.attributedobjects.ObjectEvaluationFailedException - Thrown, if the object t cannot be successfully evaluated.
      • evaluate

        default V evaluate​(T t)
                    throws java.lang.InterruptedException,
                           org.api4.java.common.attributedobjects.ObjectEvaluationFailedException
        Specified by:
        evaluate in interface org.api4.java.common.attributedobjects.IObjectEvaluator<T,​V extends java.lang.Comparable<V>>
        Throws:
        java.lang.InterruptedException
        org.api4.java.common.attributedobjects.ObjectEvaluationFailedException
      • evaluateMinimal

        default V evaluateMinimal​(T t)
                           throws java.lang.InterruptedException,
                                  org.api4.java.common.attributedobjects.ObjectEvaluationFailedException
        Evaluate the object t with minimal resources.
        Parameters:
        t - The object to be evaluated.
        Returns:
        The evaluation score for the object t.
        Throws:
        java.lang.InterruptedException - Thrown, if the evaluation routine is interrupted.
        org.api4.java.common.attributedobjects.ObjectEvaluationFailedException - Thrown, if the object t cannot be successfully evaluated.
      • evaluateMaximal

        default V evaluateMaximal​(T t)
                           throws java.lang.InterruptedException,
                                  org.api4.java.common.attributedobjects.ObjectEvaluationFailedException
        Evaluate the object t with maximal resources.
        Parameters:
        t - The object to be evaluated.
        Returns:
        The evaluation score for the object t.
        Throws:
        java.lang.InterruptedException - Thrown, if the evaluation routine is interrupted.
        org.api4.java.common.attributedobjects.ObjectEvaluationFailedException - Thrown, if the object t cannot be successfully evaluated.