Struct tpe::TpeOptimizer

pub struct TpeOptimizer<T = DefaultEstimatorBuilder> { /* fields omitted */ }

Optimizer using TPE.

This try to search out the parameter value which could minimize the evaluation result.

Note that an instance of TpeOptimizer can handle only one hyperparameter. So if you want to optimize multiple hyperparameters simultaneously, please create an optimizer for each hyperparameter.

Implementations

impl<T: BuildDensityEstimator> TpeOptimizer<T>

pub fn new(estimator_builder: T, param_range: Range) -> Self

Makes a new TpeOptimizer with the default settings.

If you want to customize the settings, please use TpeOptimizerBuilder instead.

pub fn ask<R: Rng + ?Sized>(&mut self, rng: &mut R) -> Result<f64, T::Error>

Returns the next value of the optimization target parameter to be evaluated.

Note that, before the first asking, it might be worth to give some evaluation results of randomly sampled observations to TpeOptimizer (via the tell method) to reduce bias due to too few samples.

pub fn tell(&mut self, param: f64, value: f64) -> Result<(), TellError>

Tells the evaluation result of a hyperparameter value to the optimizer.

Note that the param should be NaN if the hyperparameter was not used in the evaluation (this could be happen when the entire search space is conditional).

Trait Implementations

impl<T: Debug> Debug for TpeOptimizer<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.