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
PENDINGtrial, or aPAUSEDtrial that its bracket marked to unpause, orNoneif there’s no such trial.- Return type:
Trial | None