choose_trial_to_run#

HyperBandForBOHB.choose_trial_to_run(tune_controller: TuneController, allow_recurse: bool = True) → Trial | None[source]#

Returns the first trial that’s ready to run, in bracket creation order.

Candidate trials come from the scheduler’s brackets, not from tune_controller. If an iteration has no trial to run, look into the next iteration.

If no trial is running and no bracket has a trial to run, this method processes the brackets that have a paused trial, which can make trials ready to run.

Parameters:
  • tune_controller (TuneController) – The controller running the experiment.

  • allow_recurse (bool) – Whether to call this method once more after processing a bracket makes a trial ready to run.

Returns:

A PENDING trial, or a PAUSED trial that its bracket marked to unpause, or None if there’s no such trial.

Return type:

Trial | None