smac.acquisition.function.expected_improvement

Classes

EI([xi, log])

Expected Improvement (with or without function values in log space) acquisition function

EIPS([xi])

Expected Improvement per Second acquisition function

Interfaces

class smac.acquisition.function.expected_improvement.EI(xi=0.0, log=False)[source]

Bases: AbstractAcquisitionFunction

Expected Improvement (with or without function values in log space) acquisition function

\(EI(X) := \mathbb{E}\left[ \max\{0, f(\mathbf{X^+}) - f_{t+1}(\mathbf{X}) - \xi \} \right]\), with \(f(X^+)\) as the best location.

Parameters:
  • xi (float, defaults to 0.0) – Controls the balance between exploration and exploitation of the acquisition function.

  • log (bool, defaults to False) – Whether the function values are in log-space.

_xi

Exploration-exloitation trade-off parameter.

Type:

float

_log

Function values in log-space or not.

Type:

bool

_eta

Current incumbent function value (best value observed so far).

Type:

float

property meta: dict[str, Any]

Returns the meta data of the created object.

property name: str

Returns the full name of the acquisition function.

class smac.acquisition.function.expected_improvement.EIPS(xi=0.0)[source]

Bases: EI

Expected Improvement per Second acquisition function

\(EI(X) := \frac{\mathbb{E}\left[\max\{0,f(\mathbf{X^+})-f_{t+1}(\mathbf{X})-\xi\right]\}]}{np.log(r(x))}\), with \(f(X^+)\) as the best location and \(r(x)\) as runtime.

Parameters:

xi (float, defaults to 0.0) – Controls the balance between exploration and exploitation of the acquisition function.

property name: str

Returns the full name of the acquisition function.