
    !#h                     &    d dl mZ  G d de      Zy)    )PercentilePrunerc                   F     e Zd ZdZ	 	 	 ddddededededd	f
 fd
Z xZS )MedianPrunera	  Pruner using the median stopping rule.

    Prune if the trial's best intermediate result is worse than median of intermediate results of
    previous trials at the same step.

    Example:

        We minimize an objective function with the median stopping rule.

        .. 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.MedianPruner(
                    n_startup_trials=5, n_warmup_steps=30, interval_steps=10
                ),
            )
            study.optimize(objective, n_trials=20)

    Args:
        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.
        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.
       n_min_trialsn_startup_trialsn_warmup_stepsinterval_stepsr   returnNc                .    t         |   d||||       y )Ng      I@r   )super__init__)selfr	   r
   r   r   	__class__s        S/var/www/html/sandstorm/venv/lib/python3.12/site-packages/optuna/pruners/_median.pyr   zMedianPruner.__init__F   s$     	"NNQ] 	 	
    )   r   r   )__name__
__module____qualname____doc__intr   __classcell__)r   s   @r   r   r      sX    ?F !"	

 



 

 	

 

 


 

r   r   N)optuna.pruners._percentiler   r    r   r   <module>r      s    7L
# L
r   