-jin$SSKJr SSKrSSKJr SSKJr SSKrSSKJ r SSK J r SSK J r \(a SSKJr SS KJr S r"S S \R$S 9r\ "S5"SS\55r\ "S5SSj5r\ "S5"SS\55rg)) annotationsN)cast) TYPE_CHECKING)experimental_class)StudyDirection) TrialState) FrozenTrial)Trialzterminator:cv_scorescL\rSrSrSr\R SSj5rSrg)BaseErrorEvaluatorz Base class for error evaluators.cgNselftrialsstudy_directions U/home/james-whalen/.local/lib/python3.13/site-packages/optuna/terminator/erroreval.pyevaluateBaseErrorEvaluator.evaluates rNrzlist[FrozenTrial]rrreturnfloat) __name__ __module__ __qualname____firstlineno____doc__abcabstractmethodr__static_attributes__rrrr r s9* ! (     rr ) metaclassz3.2.0c.\rSrSrSrSSjrSrg)CrossValidationErrorEvaluator"aAn error evaluator for objective functions based on cross-validation. This evaluator evaluates the objective function's statistical error, which comes from the randomness of dataset. This evaluator assumes that the objective function is the average of the cross-validation and uses the scaled variance of the cross-validation scores in the best trial at the moment as the statistical error. cUVs/sH$o3R[R:XdM"UPM& nn[U5S:deU[R :Xa [ USS9nO [USS9nURn[U;a U[nO [S5e[U5nUS:dS5eSU- SUS- - -nU[R"U5-n [R"U 5n [U 5$s snf)akEvaluate the statistical error of the objective function based on cross-validation. Args: trials: A list of trials to consider. The best trial in ``trials`` is used to compute the statistical error. study_direction: The direction of the study. Returns: A float representing the statistical error of the objective function. rc6[[UR5$rrrvaluets r8CrossValidationErrorEvaluator.evaluate..D4qww3Gr)keyc6[[UR5$rr*r,s rr.r/Fr0rzCross-validation scores have not been reported. Please call `report_cross_validation_scores(trial, scores)` during a trial and pass the list of scores as `scores`.z9Should be guaranteed by `report_cross_validation_scores`.)staterCOMPLETElenrMAXIMIZEmaxmin system_attrs_CROSS_VALIDATION_SCORES_KEY ValueErrornpvarsqrtr) rrrtrial best_trialbest_trial_attrs cv_scoreskscaler>stds rr&CrossValidationErrorEvaluator.evaluate-s&&,RVE{{j>Q>Q/Q%VR6{Q n55 5V)GHJV)GHJ%22 '+; ;()EFI.   N1uQQQuAQU #bffY''ggclSz3Ss !C9C9rNr)rrrrr rr#rrrr&r&"s(,!,(,  ,rr&c[U5S::a [S5eURRUR[ U5 g)aA function to report cross-validation scores of a trial. This function should be called within the objective function to report the cross-validation scores. The reported scores are used to evaluate the statistical error for termination judgement. Args: trial: A :class:`~optuna.trial.Trial` object to report the cross-validation scores. scores: The cross-validation scores of the trial. r3z:The length of `scores` is expected to be greater than one.N)r6r<storageset_trial_system_attr _trial_idr;)r@scoress rreport_cross_validation_scoresrM\s8 6{aUVV MM''9UW]^rc8\rSrSrSrSSjrSSjrSrg) StaticErrorEvaluatorpaAn error evaluator that always returns a constant value. This evaluator can be used to terminate the optimization when the evaluated improvement potential is below the fixed threshold. Args: constant: A user-specified constant value to always return as an error estimate. cXlgr _constant)rconstants r__init__StaticErrorEvaluator.__init__}s!rcUR$rrRrs rrStaticErrorEvaluator.evaluates ~~rrRN)rTrrNoner)rrrrr rUrr#rrrrOrOps- "!(  rrO)r@r rLz list[float]rrY) __future__rr!typingrrnumpyr=optuna._experimentalr optuna.studyroptuna.trial._stater optuna.trialr r r;ABCMetar r&rMrOrrrrbs"  3'*(" 6  3;;  G6$666rG__&G-r