bencher.results.optimize_result

OptimizeResult — first-class container for optimization results.

Classes

OptimizeResult

Wraps an optuna.Study with bencher-friendly accessors.

Module Contents

class bencher.results.optimize_result.OptimizeResult

Wraps an optuna.Study with bencher-friendly accessors.

study: The underlying optuna study.

n_warm_start_trials: Number of trials seeded from cache / prior results.

n_new_trials: Number of new trials evaluated during optimization.

target_names: Names of the optimization target variables.

bench_cfg: Optional BenchCfg for rich report generation.

study: optuna.Study

n_warm_start_trials: int = 0

n_new_trials: int = 0

target_names: list[str] = []

bench_cfg: bencher.bench_cfg.BenchCfg | None = None

_ensure_single_objective() → None: Raise if study is multi-objective.

property best_params: dict[str, Any]: Best parameters found (single-objective only).

property best_value: float: Best objective value (single-objective only).

property best_trials: list[optuna.trial.FrozenTrial]: Pareto-optimal trials (multi-objective).

summary() → str: Return a human-readable summary of the optimization.