confirmBest

fun confirmBest(candidates: List<Solution>, evaluator: EvaluatorIfc, problemDefinition: ProblemDefinition, options: ConfirmationOptions): ConfirmationOutcome(source)

Ranks the candidates by penalized objective value, takes the top candidates per the options, re-evaluates their distinct input points in one CRN request (no caching), and returns the winner by confirmed penalized objective value.

Invalid candidates (failed members) are excluded from ranking when at least one valid candidate exists. When the finalists collapse to a single distinct input point, no evaluation is performed and the best candidate is returned as-is.

Parameters

candidates

the candidate solutions (typically the member bests), not empty

evaluator

the evaluator used for the confirmation request

problemDefinition

the problem the candidates belong to

options

the confirmation configuration