-jiSSKJr SSKJr SSKrSSKrSSKrSSKrSSK J r SSK J r SSK Jr S SjrS SjrSS jr"S S \ 5rg)) annotations)KeysViewN) BasePruner)StudyDirection) TrialStatec[R"[URR 55[ S9nU[ R:Xa[R"U5$[R"U5$)Ndtype) npasarraylistintermediate_valuesvaluesfloatrMAXIMIZEnanmaxnanmin)trial directionrs T/home/james-whalen/.local/lib/python3.13/site-packages/optuna/pruners/_percentile.py(_get_best_intermediate_result_over_stepsrsTZZU66==?@ NFN+++yy  99V c ~[U5S:Xa [S5eUVs/sH#oRUR;dMURUPM% nn[U5U:a[R$U[ R :XaSU- n[[R"[R"U[S9U55$s snf)NrzNo trials have been completed.dr ) len ValueErrorrmathnanrrrr nanpercentilearray)completed_trialsrstep percentile n_min_trialstrs r/_get_percentile_intermediate_result_over_trialsr&s !9::.>-=I^I^A^#d#-= ,.xxN+++:%   HH( 6   s B:B:cp^TU- U-U-U-nUS:de[R"U4SjUS5nXT:$)Nrc">X:aUT:waU$U$)N)second_last_stepsr"s r,_is_first_in_interval_step..>s)=!t)A$aQa$ar) functoolsreduce)r"intermediate_stepsn_warmup_stepsinterval_stepsnearest_lower_pruning_stepr*s` r_is_first_in_interval_stepr54s_ ~ "(")+9": & ** *!''a   88rcT\rSrSrSrS SS.S SjjjrS SjrSrg) PercentilePrunerFa Pruner to keep the specified percentile of the trials. Prune if the best intermediate value is in the bottom percentile among trials at the same step. Example: .. testcode:: import numpy as np from sklearn.datasets import load_iris from sklearn.linear_model import SGDClassifier from sklearn.model_selection import train_test_split import optuna X, y = load_iris(return_X_y=True) X_train, X_valid, y_train, y_valid = train_test_split(X, y) classes = np.unique(y) def objective(trial): alpha = trial.suggest_float("alpha", 0.0, 1.0) clf = SGDClassifier(alpha=alpha) n_train_iter = 100 for step in range(n_train_iter): clf.partial_fit(X_train, y_train, classes=classes) intermediate_value = clf.score(X_valid, y_valid) trial.report(intermediate_value, step) if trial.should_prune(): raise optuna.TrialPruned() return clf.score(X_valid, y_valid) study = optuna.create_study( direction="maximize", pruner=optuna.pruners.PercentilePruner( 25.0, n_startup_trials=5, n_warmup_steps=30, interval_steps=10 ), ) study.optimize(objective, n_trials=20) Args: percentile: Percentile which must be between 0 and 100 inclusive (e.g., When given 25.0, top of 25th percentile trials are kept). n_startup_trials: Pruning is disabled until the given number of trials finish in the same study. n_warmup_steps: Pruning is disabled until the trial exceeds the given number of step. Note that this feature assumes that ``step`` starts at zero. interval_steps: Interval in number of steps between the pruning checks, offset by the warmup steps. If no value has been reported at the time of a pruning check, that particular check will be postponed until a value is reported. Value must be at least 1. n_min_trials: Minimum number of reported trial results at a step to judge whether to prune. If the number of reported intermediate values from all trials at the current step is less than ``n_min_trials``, the trial will not be pruned. This can be used to ensure that a minimum number of trials are run to completion without being pruned. )r$c.SUs=::aS::dO [SU<S35eUS:a[SU<S35eUS:a[SU<S35eUS:a[S U<S35eUS:a[S U<S35eXlX lX0lX@lXPlg) NgrzCPercentile must be between 0 and 100 inclusive, but got percentile=.rzFNumber of startup trials cannot be negative, but got n_startup_trials=zBNumber of warmup steps cannot be negative, but got n_warmup_steps=r9zBPruning interval steps must be at least 1, but got interval_steps=zFNumber of trials for pruning must be at least 1, but got n_min_trials=)r _percentile_n_startup_trials_n_warmup_steps_interval_steps _n_min_trials)selfr#n_startup_trialsr2r3r$s r__init__PercentilePruner.__init__sj'C'V:-WXY  a YHXGZZ[\  A UnEVVWX  A UnEVVWX  ! YL?Z[\ &!1--)rcHURS[R4S9n[U5nUS:XagX@R:agUR nUcgUR nXV:ag[XRRR5X`R5(dgURn[X'5n[R"U5(ag[X7XPR UR"5n [R"U 5(agU[$R&:XaX:$X:$)NF)deepcopystatesrT) get_trialsrCOMPLETErr= last_stepr>r5rkeysr?rrrisnanr&r<r@rr) rAstudyrr!n_trialsr"r2rbest_intermediate_resultps rprunePercentilePruner.prunes  ++UJDWDWCY+Z'( q= ,, , <--  ) ++002NDXDX  OO #KE#] ::. / / ; /?/?ASAS  ::a== // /+/ /'++r)r?r@r=r>r<N)rr9) r#rrBintr2rTr3rTr$rTreturnNone)rMz'optuna.study.Study'r'optuna.trial.FrozenTrial'rUbool)__name__ __module__ __qualname____firstlineno____doc__rCrQ__static_attributes__r)rrr7r7Fsb?H!" "*"*"*"* "*  "*"* "*H$,rr7)rrWrrrUr) r!z list['optuna.trial.FrozenTrial']rrr"rTr#rr$rTrUr) r"rTr1z KeysView[int]r2rTr3rTrUrX) __future__rcollections.abcrr/rnumpyr optunaoptuna.prunersroptuna.study._study_directionroptuna.trial._staterrr&r5r7r)rrrfs"$  %8* %2@ 6      89 9#09BE9WZ9 9$J,zJ,r