a j07@sdZddlmZmZddlZddlmZmZm Z m Z m Z ddl m Z mZddlmZmZddlmZmZmZmZmZdd lmZmZmZmZdd lmZdd lm Z m!Z!d d l"m#Z#Gddde#eeZ$dS)z Sequential feature selection )IntegralRealN) BaseEstimatorMetaEstimatorMixin _fit_contextclone is_classifier) check_scoringget_scorer_names)check_cvcross_val_score)MetadataRouter MethodMapping_raise_for_params_routing_enabledprocess_routing) HasMethodsInterval RealNotInt StrOptions)get_tags)check_is_fitted validate_data) SelectorMixinc seZdZUdZedggedheeddddeeddd dgdee ddd dged d hgdee e e gd gdegd Z eed<ddd ddddddZedddddZddZddZfddZddZZS) SequentialFeatureSelectoraTransformer that performs Sequential Feature Selection. This Sequential Feature Selector adds (forward selection) or removes (backward selection) features to form a feature subset in a greedy fashion. At each stage, this estimator chooses the best feature to add or remove based on the cross-validation score of an estimator. In the case of unsupervised learning, this Sequential Feature Selector looks only at the features (X), not the desired outputs (y). Read more in the :ref:`User Guide `. .. versionadded:: 0.24 Parameters ---------- estimator : estimator instance An unfitted estimator. n_features_to_select : "auto", int or float, default="auto" If `"auto"`, the behaviour depends on the `tol` parameter: - if `tol` is not `None`, then features are selected while the score change does not exceed `tol`. - otherwise, half of the features are selected. If integer, the parameter is the absolute number of features to select. If float between 0 and 1, it is the fraction of features to select. .. versionadded:: 1.1 The option `"auto"` was added in version 1.1. .. versionchanged:: 1.3 The default changed from `"warn"` to `"auto"` in 1.3. tol : float, default=None If the score is not incremented by at least `tol` between two consecutive feature additions or removals, stop adding or removing. `tol` can be negative when removing features using `direction="backward"`. `tol` is required to be strictly positive when doing forward selection. It can be useful to reduce the number of features at the cost of a small decrease in the score. `tol` is enabled only when `n_features_to_select` is `"auto"`. .. versionadded:: 1.1 direction : {'forward', 'backward'}, default='forward' Whether to perform forward selection or backward selection. scoring : str or callable, default=None A single str (see :ref:`scoring_parameter`) or a callable (see :ref:`scoring_callable`) to evaluate the predictions on the test set. NOTE that when using a custom scorer, it should return a single value. If None, the estimator's score method is used. cv : int, cross-validation generator or an iterable, default=None Determines the cross-validation splitting strategy. Possible inputs for cv are: - None, to use the default 5-fold cross validation, - integer, to specify the number of folds in a `(Stratified)KFold`, - :term:`CV splitter`, - An iterable yielding (train, test) splits as arrays of indices. For integer/None inputs, if the estimator is a classifier and ``y`` is either binary or multiclass, :class:`~sklearn.model_selection.StratifiedKFold` is used. In all other cases, :class:`~sklearn.model_selection.KFold` is used. These splitters are instantiated with `shuffle=False` so the splits will be the same across calls. Refer :ref:`User Guide ` for the various cross-validation strategies that can be used here. n_jobs : int, default=None Number of jobs to run in parallel. When evaluating a new feature to add or remove, the cross-validation procedure is parallel over the folds. ``None`` means 1 unless in a :obj:`joblib.parallel_backend` context. ``-1`` means using all processors. See :term:`Glossary ` for more details. Attributes ---------- n_features_in_ : int Number of features seen during :term:`fit`. Only defined if the underlying estimator exposes such an attribute when fit. .. versionadded:: 0.24 feature_names_in_ : ndarray of shape (`n_features_in_`,) Names of features seen during :term:`fit`. Defined only when `X` has feature names that are all strings. .. versionadded:: 1.0 n_features_to_select_ : int The number of features that were selected. support_ : ndarray of shape (n_features,), dtype=bool The mask of selected features. See Also -------- GenericUnivariateSelect : Univariate feature selector with configurable strategy. RFE : Recursive feature elimination based on importance weights. RFECV : Recursive feature elimination based on importance weights, with automatic selection of the number of features. SelectFromModel : Feature selection based on thresholds of importance weights. Examples -------- >>> from sklearn.feature_selection import SequentialFeatureSelector >>> from sklearn.neighbors import KNeighborsClassifier >>> from sklearn.datasets import load_iris >>> X, y = load_iris(return_X_y=True) >>> knn = KNeighborsClassifier(n_neighbors=3) >>> sfs = SequentialFeatureSelector(knn, n_features_to_select=3) >>> sfs.fit(X, y) SequentialFeatureSelector(estimator=KNeighborsClassifier(n_neighbors=3), n_features_to_select=3) >>> sfs.get_support() array([ True, False, True, True]) >>> sfs.transform(X).shape (150, 3) fitautorrright)closedNZneitherforwardbackwardZ cv_object estimatorn_features_to_selecttol directionscoringcvn_jobs_parameter_constraints)r%r&r'r(r)r*cCs.||_||_||_||_||_||_||_dSNr#)selfr$r%r&r'r(r)r*r/KE:\soccer\ml_env\Lib\site-packages\sklearn/feature_selection/_sequential.py__init__s z"SequentialFeatureSelector.__init__F)Zprefer_skip_nested_validationcKst||d|}t||dd|jj d}|jd}|jdkrb|jdurV|d|_q|d|_nDt |jt r|j|krt d|j|_nt |jt rt ||j|_|jdur|jd kr|jd krt d t|j|t|jd }t|j}tj|td }|jdks|jd kr|jn||j} tj } |jduo>|jdk} trZt|dfi|t| D]L} |j|||||fi|\} }| r|| |jkrq|} d|| <qb|jdkr|}||_|j|_|S)aLearn the features to select from X. Parameters ---------- X : array-like of shape (n_samples, n_features) Training vectors, where `n_samples` is the number of samples and `n_features` is the number of predictors. y : array-like of shape (n_samples,), default=None Target values. This parameter may be ignored for unsupervised learning. **params : dict, default=None Parameters to be passed to the underlying `estimator`, `cv` and `scorer` objects. .. versionadded:: 1.6 Only available if `enable_metadata_routing=True`, which can be set by using ``sklearn.set_config(enable_metadata_routing=True)``. See :ref:`Metadata Routing User Guide ` for more details. Returns ------- self : object Returns the instance itself. rZcscr)Z accept_sparseZensure_min_featuresZensure_all_finiterrNz*n_features_to_select must be < n_features.rr!z:tol must be strictly positive when doing forward selection classifier)shapeZdtypeTr")r__sklearn_tags__r input_tags allow_nanr4r%r&Zn_features_to_select_ isinstancer ValueErrorrintr'r r)r r$rnpZzerosboolinfrrrange_get_best_new_feature_scoresupport_sum)r.XyparamstagsZ n_featuresr)Zcloned_estimator current_maskZ n_iterationsZ old_scoreZis_auto_select_new_feature_idxZ new_scorer/r/r0rsh"                  zSequentialFeatureSelector.fitc st|}i|D]V}|} d| |<|jdkr8| } |dd| f} t|| |||j|j|d|<qtfddd} | | fS)NTr")r)r(r*rDcs|Sr-r/) feature_idxZscoresr/r0BzGSequentialFeatureSelector._get_best_new_feature_score..)key) r;Z flatnonzerocopyr'r r(r*meanmax) r.r$rBrCr)rFrDZcandidate_feature_indicesrIZcandidate_maskZX_newrHr/rJr0r?+s&   z5SequentialFeatureSelector._get_best_new_feature_scorecCst||jSr-)rr@)r.r/r/r0_get_support_maskEsz+SequentialFeatureSelector._get_support_maskcs2t}t|jjj|j_t|jjj|j_|Sr-)superr5rr$r6r7sparse)r.rE __class__r/r0r5Is z*SequentialFeatureSelector.__sklearn_tags__cCs~t|jjd}|j|jtjdddd|jt|jt|jdtjdddd|jt |j|j dtjdd dd |S) ajGet metadata routing of this object. Please check :ref:`User Guide ` on how the routing mechanism works. .. versionadded:: 1.6 Returns ------- routing : MetadataRouter A :class:`~sklearn.utils.metadata_routing.MetadataRouter` encapsulating routing information. )ownerr)ZcallerZcallee)r$method_mappingr2split)ZsplitterrW)r(Zscore)ZscorerrW) rrU__name__addr$rr r)r r r()r.Zrouterr/r/r0get_metadata_routingOsz.SequentialFeatureSelector.get_metadata_routing)N)rY __module__ __qualname____doc__rrrrrrsetr callabler+dict__annotations__r1rrr?rQr5r[ __classcell__r/r/rTr0rs8     d r)%r^numbersrrnumpyr;baserrrrr Zmetricsr r Zmodel_selectionr r Zutils._metadata_requestsrrrrrZutils._param_validationrrrrZ utils._tagsrZutils.validationrrZ_baserrr/r/r/r0s