ray.tune.ResultGrid.get_best_result#

ResultGrid.get_best_result(metric: str | None = None, mode: str | None = None, scope: str = 'last', filter_nan_and_inf: bool = True) → Result[source]#

Get the best result from all the trials run.

Parameters:

  • metric – Key for trial info to order on. Defaults to the metric specified in your Tuner’s TuneConfig.

  • mode – One of [min, max]. Defaults to the mode specified in your Tuner’s TuneConfig.

  • scope – One of [all, last, avg, last-5-avg, last-10-avg]. If scope=last, only look at each trial’s final step for metric, and compare across trials based on mode=[min,max]. If scope=avg, consider the simple average over all steps for metric and compare across trials based on mode=[min,max]. If scope=last-5-avg or scope=last-10-avg, consider the simple average over the last 5 or 10 steps for metric and compare across trials based on mode=[min,max]. If scope=all, find each trial’s min/max score for metric based on mode, and compare trials based on mode=[min,max].

  • filter_nan_and_inf – If True (default), NaN or infinite values are disregarded and these trials are never selected as the best trial.