BOHB - Bayesian Optimization and Hyperband

class hpbandster.optimizers.bohb.BOHB(configspace=None, eta=3, min_budget=0.01, max_budget=1, min_points_in_model=None, top_n_percent=15, num_samples=64, random_fraction=0.3333333333333333, bandwidth_factor=3, min_bandwidth=0.001, **kwargs)[source]

BOHB performs robust and efficient hyperparameter optimization at scale by combining the speed of Hyperband searches with the guidance and guarantees of convergence of Bayesian Optimization. Instead of sampling new configurations at random, BOHB uses kernel density estimators to select promising candidates.

For reference:

@InProceedings{falkner-icml-18,
  title =        {{BOHB}: Robust and Efficient Hyperparameter Optimization at Scale},
  author =       {Falkner, Stefan and Klein, Aaron and Hutter, Frank},
  booktitle =    {Proceedings of the 35th International Conference on Machine Learning},
  pages =        {1436--1445},
  year =         {2018},
}
Parameters:
  • configspace (ConfigSpace object) – valid representation of the search space
  • eta (float) – In each iteration, a complete run of sequential halving is executed. In it, after evaluating each configuration on the same subset size, only a fraction of 1/eta of them ‘advances’ to the next round. Must be greater or equal to 2.
  • min_budget (float) – The smallest budget to consider. Needs to be positive!
  • max_budget (float) – The largest budget to consider. Needs to be larger than min_budget! The budgets will be geometrically distributed \(a^2 + b^2 = c^2 \sim \eta^k\) for \(k\in [0, 1, ... , num\_subsets - 1]\).
  • min_points_in_model (int) – number of observations to start building a KDE. Default ‘None’ means dim+1, the bare minimum.
  • top_n_percent (int) – percentage ( between 1 and 99, default 15) of the observations that are considered good.
  • num_samples (int) – number of samples to optimize EI (default 64)
  • random_fraction (float) – fraction of purely random configurations that are sampled from the prior without the model.
  • bandwidth_factor (float) – to encourage diversity, the points proposed to optimize EI, are sampled from a ‘widened’ KDE where the bandwidth is multiplied by this factor (default: 3)
  • min_bandwidth (float) – to keep diversity, even when all (good) samples have the same value for one of the parameters, a minimum bandwidth (Default: 1e-3) is used instead of zero.
  • iteration_kwargs (dict) – kwargs to be added to the instantiation of each iteration
get_next_iteration(iteration, iteration_kwargs={})[source]

BO-HB uses (just like Hyperband) SuccessiveHalving for each iteration. See Li et al. (2016) for reference.

Parameters:iteration (int) – the index of the iteration to be instantiated
Returns:SuccessiveHalving – corresponding number of configurations
Return type:the SuccessiveHalving iteration with the