Target Algorithm Evaluator¶

SMAC evaluates the algorithm to be optimized by invoking it through a Target Algorithm Evaluator (TAE). There are different TAEs implemented in SMAC which provide slightly different interfaces. You can see SVM-example for an example on the usage.

  • smac.tae.execute_ta_run_old: Used when calling SMAC via the commandline, where it takes the algorithm call from the algo-parameter of the scenario. The parameters will be appended to the algorithm call, which in total looks like:

    <algo> <instance> <instance specific> <cutoff time> <runlength> <seed> <algorithm parameters>
    python 123 0 10 25 12345 -param1 value1 -param2 value2 [...]

    The first two parameters after the are the instance name, on which the target algorithm is evaluated, and extra information about the instance (rarely used). The third parameter is the cutoff time, which is the maximal time the target algorithm is allowed to run. The fourth parameter is the runlength, which is the maximal number of steps an algorithm is allowed to run. The fifth parameter is the random seed which is followed by the target algorithm parameters.

    It expects the target algorithm to print a string during execution with on of the following formats:

    Result of this algorithm run: <STATUS>, <running time>, <runlength>, <quality>, <seed>, <instance-specifics>
    Result for SMAC: <STATUS>, <running time>, <runlength>, <quality>, <seed>, <instance-specifics>
    Result for ParamILS: <STATUS>, <running time>, <runlength>, <quality>, <seed>, <instance-specifics>

    The examples Branin or SPEAR reflect the usage.

    • STATUS can be one of [SAT, UNSAT, SUCCESS, TIMEOUT, MEMOUT, CRASHED, ABORT]. SAT and UNSAT are mainly supported for backcompatibility and are treated as SUCCESS. The difference between CRASHED and ABORT is that ABORT is called when all future calls are assumed to crash and will abort the whole optimization, whereas CRASHED only indicates a single failed run.

    • running time indicates the time that the execution took.

    • runlength indicates the number of steps needed for execution.

    • quality is the solution quality.

    • seed is the seed used for the algorithm call.

    • instance-specifics is additional information.

  • ExecuteTAFuncDict and ExecuteTAFuncArray: The target algorithm is called with a dict- or array-like configuration and optionally with seed and instance, returning either the loss as a float or a tuple (loss, additional information). This is very handy when used within Python to optimize any blackbox-function. Using this TAE, there is no need to print a result string; the error will be interpreted from the return value. Just be aware of the fact that SMAC is always minimizing as well as the function needs to be able to interpret the configuration correctly. With this TAE, Pynisher is used to enforce time- and memory-limits.