Version 0.22
scikit-learn Docs · نسخهٔ 5e9184e53cd3 · BSD-3-Clause
============
Version 0.22
For a short description of the main highlights of the release, please refer to sphx_glr_auto_examples_release_highlights_plot_release_highlights_0_22_0.py.
Version 0.22.2.post1
March 3 2020
The 0.22.2.post1 release includes a packaging fix for the source distribution but the content of the packages is otherwise identical to the content of the wheels with the 0.22.2 version (without the .post1 suffix). Both contain the following changes.
Changelog
sklearn.impute .....................
- |Efficiency| Reduce
impute.KNNImputerasymptotic memory usage by
chunking pairwise distance computation. 16397 by Joel Nothman_.
sklearn.metrics ......................
- |Fix| Fixed a bug in
metrics.plot_roc_curvewhere
the name of the estimator was passed in the metrics.RocCurveDisplay instead of the parameter name. It results in a different plot when calling metrics.RocCurveDisplay.plot for the subsequent times. 16500 by Guillaume Lemaitre <glemaitre>.
- |Fix| Fixed a bug in
metrics.plot_precision_recall_curvewhere the
name of the estimator was passed in the metrics.PrecisionRecallDisplay instead of the parameter name. It results in a different plot when calling metrics.PrecisionRecallDisplay.plot for the subsequent times. 16505 by Guillaume Lemaitre <glemaitre>.
sklearn.neighbors ........................
- |Fix| Fix a bug which converted a list of arrays into a 2-D object
array instead of a 1-D array containing NumPy arrays. This bug was affecting neighbors.NearestNeighbors.radius_neighbors. 16076 by Guillaume Lemaitre <glemaitre> and Alex Shacked <alexshacked>.
Version 0.22.1
January 2 2020
This is a bug-fix release to primarily resolve some packaging issues in version 0.22.0. It also includes minor documentation improvements and some bug fixes.
Changelog
sklearn.cluster ......................
- |Fix|
cluster.KMeanswith `algorithm="elkan"` now uses the same
stopping criterion as with the default `algorithm="full". 15930 by inder128`.
sklearn.inspection .........................
- |Fix|
inspection.permutation_importancewill return the same
importances when a random_state is given for both n_jobs=1 or n_jobs>1 both with shared memory backends (thread-safety) and isolated memory, process-based backends. Also avoid casting the data as object dtype and avoid read-only error on large dataframes with n_jobs>1 as reported in 15810. Follow-up of 15898 by Shivam Gargsya <shivamgargsya>. 15933 by Guillaume Lemaitre <glemaitre> and Olivier Grisel_.
- |Fix|
inspection.plot_partial_dependenceand
inspection.PartialDependenceDisplay.plot now consistently checks the number of axes passed in. 15760 by Thomas Fan_.
sklearn.metrics ......................
- |Fix|
metrics.plot_confusion_matrixnow raises error whennormalize
is invalid. Previously, it runs fine with no normalization. 15888 by Hanmin Qin_.
- |Fix|
metrics.plot_confusion_matrixnow colors the label color
correctly to maximize contrast with its background. 15936 by Thomas Fan_ and DizietAsahi.
- |Fix|
metrics.classification_reportdoes no longer ignore the
value of the `zero_division keyword argument. 15879 by Bibhash Chandra Mitra <Bibyutatsu>`.
- |Fix| Fixed a bug in
metrics.plot_confusion_matrixto correctly
pass the values_format parameter to the metrics.ConfusionMatrixDisplay plot() call. 15937 by Stephen Blystone <blynotes>.
sklearn.model_selection ..............................
- |Fix|
model_selection.GridSearchCVand
model_selection.RandomizedSearchCV accept scalar values provided in fit_params. Change in 0.22 was breaking backward compatibility. 15863 by Adrin Jalali <adrinjalali> and Guillaume Lemaitre <glemaitre>.
sklearn.naive_bayes ..........................
- |Fix| Removed
abstractmethoddecorator for the method_check_Xin
naive_bayes.BaseNB that could break downstream projects inheriting from this deprecated public base class. 15996 by Brigitta Sipőcz <bsipocz>.
sklearn.preprocessing ............................
- |Fix|
preprocessing.QuantileTransformernow guarantees the
quantiles_ attribute to be completely sorted in non-decreasing manner. 15751 by Tirth Patel <tirthasheshpatel>.
sklearn.semi_supervised ..............................
- |Fix|
semi_supervised.LabelPropagationand
semi_supervised.LabelSpreading now allow callable kernel function to return sparse weight matrix. 15868 by Niklas Smedemark-Margulies <nik-sm>.
sklearn.utils ....................
- |Fix|
utils.check_arraynow correctly converts pandas DataFrame with
boolean columns to floats. 15797 by Thomas Fan_.
- |Fix|
utils.validation.check_is_fittedaccepts back an explicit `attributes`
argument to check for specific attributes as explicit markers of a fitted estimator. When no explicit `attributes are provided, only the attributes that end with an underscore and do not start with double underscore are used as "fitted" markers. The all_or_any argument is also no longer deprecated. This change is made to restore some backward compatibility with the behavior of this utility in version 0.21. 15947 by Thomas Fan`_.
Version 0.22.0
December 3 2019
Website update
Our website <https://scikit-learn.org/>_ was revamped and given a fresh new look. 14849 by Thomas Fan_.
Clear definition of the public API
Scikit-learn has a public API, and a private API.
We do our best not to break the public API, and to only introduce backward-compatible changes that do not require any user action. However, in cases where that's not possible, any change to the public API is subject to a deprecation cycle of two minor versions. The private API isn't publicly documented and isn't subject to any deprecation cycle, so users should not rely on its stability.
A function or object is public if it is documented in the API Reference <https://scikit-learn.org/dev/modules/classes.html>_ and if it can be imported with an import path without leading underscores. For example `sklearn.pipeline.make_pipeline is public, while sklearn.pipeline._name_estimators is private. sklearn.ensemble._gb.BaseEnsemble is private too because the whole _gb` module is private.
Up to 0.22, some tools were de-facto public (no leading underscore), while they should have been private in the first place. In version 0.22, these tools have been made properly private, and the public API space has been cleaned. In addition, importing from most sub-modules is now deprecated: you should for example use `from sklearn.cluster import Birch instead of from sklearn.cluster.birch import Birch (in practice, birch.py has been moved to _birch.py`).
All the tools in the public API should be documented in the API Reference <https://scikit-learn.org/dev/modules/classes.html>_. If you find a public tool (without leading underscore) that isn't in the API reference, that means it should either be private or documented. Please let us know by opening an issue!
This work was tracked in issue 9250 <https://github.com/scikit-learn/scikit-learn/issues/9250>_ and issue 12927 <https://github.com/scikit-learn/scikit-learn/issues/12927>_.
Deprecations: using `FutureWarning` from now on
When deprecating a feature, previous versions of scikit-learn used to raise a `DeprecationWarning. Since the DeprecationWarnings` aren't shown by default by Python, scikit-learn needed to resort to a custom warning filter to always show the warnings. That filter would sometimes interfere with users custom warning filters.
Starting from version 0.22, scikit-learn will show `FutureWarnings for deprecations, as recommended by the Python documentation <https://docs.python.org/3/library/exceptions.html#FutureWarning>_. FutureWarnings are always shown by default by Python, so the custom filter has been removed and scikit-learn no longer hinders with user filters. 15080 by Nicolas Hug`_.
Changed models
The following estimators and functions, when fit with the same data and parameters, may produce different models from the previous version. This often occurs due to changes in the modelling logic (bug fixes or enhancements), or in random sampling procedures.
cluster.KMeanswhenn_jobs=1. |Fix|decomposition.SparseCoder,
decomposition.DictionaryLearning, and decomposition.MiniBatchDictionaryLearning |Fix|
decomposition.SparseCoderwithalgorithm='lasso_lars'|Fix|decomposition.SparsePCAwherenormalize_componentshas no effect
due to deprecation.
ensemble.HistGradientBoostingClassifierand
ensemble.HistGradientBoostingRegressor |Fix|, |Feature|,
| Enhancement | . |
impute.IterativeImputerwhenXhas features with no missing
values. |Feature|
linear_model.RidgewhenXis sparse. |Fix|model_selection.StratifiedKFoldand any use ofcv=intwith a
classifier. |Fix|
cross_decomposition.CCAwhen using scipy >= 1.3 |Fix|
Details are listed in the changelog below.
(While we are trying to better inform users by providing this information, we cannot assure that this list is complete.)
Changelog
.. Entries should be grouped by module (in alphabetic order) and prefixed with one of the labels: |MajorFeature|, |Feature|, |Efficiency|, |Enhancement|,
| Fix | or | API | (see whats_new.rst for descriptions). |
Entries should be ordered by those labels (e.g. |Fix| after |Efficiency|). Changes not specific to a module should be listed under *Multiple Modules* or *Miscellaneous*. Entries should end with: 123456 by Joe Bloggs <joeongithub>. where 123456 is the *pull request* number, not the issue number.
sklearn.base ...................
- |API| From version 0.24
base.BaseEstimator.get_paramswill raise an
AttributeError rather than return None for parameters that are in the estimator's constructor but not stored as attributes on the instance. 14464 by Joel Nothman_.
sklearn.calibration ..........................
- |Fix| Fixed a bug that made
calibration.CalibratedClassifierCVfail when
given a sample_weight parameter of type list (in the case where sample_weights are not supported by the wrapped estimator). 13575 by William de Vazelhes <wdevazelhes>.
sklearn.cluster ......................
- |Feature|
cluster.SpectralClusteringnow accepts precomputed sparse
neighbors graph as input. 10482 by Tom Dupre la Tour_ and Kumar Ashutosh <thechargedneutron>.
- |Enhancement|
cluster.SpectralClusteringnow accepts a `n_components`
parameter. This parameter extends SpectralClustering class functionality to match cluster.spectral_clustering. 13726 by Shuzhe Xiao <fdas3213>.
- |Fix| Fixed a bug where
cluster.KMeansproduced inconsistent results
between n_jobs=1 and n_jobs>1 due to the handling of the random state. 9288 by Bryan Yang <bryanyang0528>.
- |Fix| Fixed a bug where
elkanalgorithm incluster.KMeanswas
producing Segmentation Fault on large arrays due to integer index overflow. 15057 by Vladimir Korolev <balodja>.
- |Fix|
~cluster.MeanShiftnow accepts amax_iterwith a
default value of 300 instead of always using the default 300. It also now exposes an `n_iter_ indicating the maximum number of iterations performed on each seed. 15120 by Adrin Jalali`_.
- |Fix|
cluster.AgglomerativeClusteringand
cluster.FeatureAgglomeration now raise an error if affinity='cosine' and X has samples that are all-zeros. 7943 by mthorrell.
sklearn.compose ......................
- |Feature| Adds
compose.make_column_selectorwhich is used with
compose.ColumnTransformer to select DataFrame columns on the basis of name and dtype. 12303 by Thomas Fan_.
- |Fix| Fixed a bug in
compose.ColumnTransformerwhich failed to
select the proper columns when using a boolean list, with NumPy older than 1.12. 14510 by Guillaume Lemaitre_.
- |Fix| Fixed a bug in
compose.TransformedTargetRegressorwhich did not
pass **fit_params to the underlying regressor. 14890 by Miguel Cabrera <mfcabrera>.
- |Fix| The
compose.ColumnTransformernow requires the number of
features to be consistent between fit and transform. A FutureWarning is raised now, and this will raise an error in 0.24. If the number of features isn't consistent and negative indexing is used, an error is raised. 14544 by Adrin Jalali_.
sklearn.cross_decomposition ..................................
- |Feature|
cross_decomposition.PLSCanonicaland
cross_decomposition.PLSRegression have a new function `inverse_transform to transform data to the original space. 15304 by Jaime Ferrando Huertas <jiwidi>`.
- |Enhancement|
decomposition.KernelPCAnow properly checks the
eigenvalues found by the solver for numerical or conditioning issues. This ensures consistency of results across solvers (different choices for `eigen_solver), including approximate solvers such as 'randomized' and 'lobpcg' (see 12068). 12145 by Sylvain Marié <smarie>`
- |Fix| Fixed a bug where
cross_decomposition.PLSCanonicaland
cross_decomposition.PLSRegression were raising an error when fitted with a target matrix Y in which the first column was constant. 13609 by Camila Williamson <camilaagw>.
- |Fix|
cross_decomposition.CCAnow produces the same results with
scipy 1.3 and previous scipy versions. 15661 by Thomas Fan_.
sklearn.datasets .......................
- |Feature|
datasets.fetch_openmlnow supports heterogeneous data using
pandas by setting as_frame=True. 13902 by Thomas Fan_.
- |Feature|
datasets.fetch_openmlnow includes thetarget_namesin
the returned Bunch. 15160 by Thomas Fan_.
- |Enhancement| The parameter
return_X_ywas added to
datasets.fetch_20newsgroups and datasets.fetch_olivetti_faces . 14259 by Sourav Singh <souravsingh>.
- |Enhancement|
datasets.make_classificationnow accepts array-like
weights parameter, i.e. list or numpy.array, instead of list only. 14764 by Cat Chenal <CatChenal>.
- |Enhancement| The parameter
normalizewas added to
datasets.fetch_20newsgroups_vectorized. 14740 by Stéphan Tulkens <stephantul>
- |Fix| Fixed a bug in
datasets.fetch_openml, which failed to load
an OpenML dataset that contains an ignored feature. 14623 by Sarra Habchi <HabchiSarra>.
sklearn.decomposition ............................
- |Efficiency|
decomposition.NMFwithsolver="mu"fitted on sparse input
matrices now uses batching to avoid briefly allocating an array with size (#non-zero elements, n_components). 15257 by Mart Willocx <Maocx>.
- |Enhancement|
decomposition.dict_learningand
decomposition.dict_learning_online now accept method_max_iter and pass it to decomposition.sparse_encode. 12650 by Adrin Jalali_.
- |Enhancement|
decomposition.SparseCoder,
decomposition.DictionaryLearning, and decomposition.MiniBatchDictionaryLearning now take a transform_max_iter parameter and pass it to either decomposition.dict_learning or decomposition.sparse_encode. 12650 by Adrin Jalali_.
- |Enhancement|
decomposition.IncrementalPCAnow accepts sparse
matrices as input, converting them to dense in batches thereby avoiding the need to store the entire dense matrix at once. 13960 by Scott Gigante <scottgigante>.
- |Fix|
decomposition.sparse_encodenow passes themax_iterto the
underlying linear_model.LassoLars when algorithm='lasso_lars'. 12650 by Adrin Jalali_.
sklearn.dummy ....................
- |Fix|
dummy.DummyClassifiernow handles checking the existence
of the provided constant in multioutput cases. 14908 by Martina G. Vilas <martinagvilas>.
- |API| The default value of the
strategyparameter in
dummy.DummyClassifier will change from 'stratified' in version 0.22 to 'prior' in 0.24. A FutureWarning is raised when the default value is used. 15382 by Thomas Fan_.
- |API| The `
outputs_2d_` attribute is deprecated in
dummy.DummyClassifier and dummy.DummyRegressor. It is equivalent to `n_outputs > 1. 14933 by Nicolas Hug`_
sklearn.ensemble .......................
- |MajorFeature| Added
ensemble.StackingClassifierand
ensemble.StackingRegressor to stack predictors using a final classifier or regressor. 11047 by :user:Guillaume Lemaitre <glemaitre> and Caio Oliveira <caioaao> and 15138 by Jon Cusick <jcusick13>..
- |MajorFeature| Many improvements were made to
ensemble.HistGradientBoostingClassifier and ensemble.HistGradientBoostingRegressor:
- |Feature| Estimators now natively support dense data with missing
values both for training and predicting. They also support infinite values. 13911 and 14406 by Nicolas Hug_, Adrin Jalali_ and Olivier Grisel_.
- |Feature| Estimators now have an additional
warm_startparameter that
enables warm starting. 14012 by Johann Faouzi <johannfaouzi>.
- |Feature|
inspection.partial_dependenceand
inspection.plot_partial_dependence now support the fast 'recursion' method for both estimators. 13769 by Nicolas Hug_.
- |Enhancement| for
ensemble.HistGradientBoostingClassifierthe
training loss or score is now monitored on a class-wise stratified subsample to preserve the class balance of the original training set. 14194 by Johann Faouzi <johannfaouzi>.
- |Enhancement|
ensemble.HistGradientBoostingRegressornow supports
the 'least_absolute_deviation' loss. 13896 by Nicolas Hug_.
- |Fix| Estimators now bin the training and validation data separately to
avoid any data leak. 13933 by Nicolas Hug_.
- |Fix| Fixed a bug where early stopping would break with string targets.
14710 by Guillaume Lemaitre_.
- |Fix|
ensemble.HistGradientBoostingClassifiernow raises an error
if `categorical_crossentropy loss is given for a binary classification problem. 14869 by Adrin Jalali`_.
Note that pickles from 0.21 will not work in 0.22.
- |Enhancement| Addition of `
max_samples` argument allows limiting
size of bootstrap samples to be less than size of dataset. Added to ensemble.RandomForestClassifier, ensemble.RandomForestRegressor, ensemble.ExtraTreesClassifier, ensemble.ExtraTreesRegressor. 14682 by Matt Hancock <notmatthancock> and 5963 by Pablo Duboue <DrDub>.
- |Fix|
ensemble.VotingClassifier.predict_probawill no longer be
present when voting='hard'. 14287 by Thomas Fan_.
- |Fix| The
named_estimators_attribute inensemble.VotingClassifier
and ensemble.VotingRegressor now correctly maps to dropped estimators. Previously, the named_estimators_ mapping was incorrect whenever one of the estimators was dropped. 15375 by Thomas Fan_.
- |Fix| Run by default
utils.estimator_checks.check_estimator on both ensemble.VotingClassifier and ensemble.VotingRegressor. It leads to solve issues regarding shape consistency during predict which was failing when the underlying estimators were not outputting consistent array dimensions. Note that it should be replaced by refactoring the common tests in the future. 14305 by Guillaume Lemaitre_.
- |Fix|
ensemble.AdaBoostClassifiercomputes probabilities based on
the decision function as in the literature. Thus, predict and predict_proba give consistent results. 14114 by Guillaume Lemaitre_.
- |Fix| Stacking and Voting estimators now ensure that their underlying
estimators are either all classifiers or all regressors. ensemble.StackingClassifier, ensemble.StackingRegressor, and ensemble.VotingClassifier and ensemble.VotingRegressor now raise consistent error messages. 15084 by Guillaume Lemaitre_.
- |Fix|
ensemble.AdaBoostRegressorwhere the loss should be normalized
by the max of the samples with non-null weights only. 14294 by Guillaume Lemaitre_.
- |API| `
presort` is now deprecated in
ensemble.GradientBoostingClassifier and ensemble.GradientBoostingRegressor, and the parameter has no effect. Users are recommended to use ensemble.HistGradientBoostingClassifier and ensemble.HistGradientBoostingRegressor instead. 14907 by Adrin Jalali_.
sklearn.feature_extraction .................................
- |Enhancement| A warning will now be raised if a parameter choice means
that another parameter will be unused on calling the fit() method for feature_extraction.text.HashingVectorizer, feature_extraction.text.CountVectorizer and feature_extraction.text.TfidfVectorizer. 14602 by Gaurav Chawla <getgaurav2>.
- |Fix| Functions created by `
build_preprocessorandbuild_analyzer` of
feature_extraction.text.VectorizerMixin can now be pickled. 14430 by Dillon Niederhut <deniederhut>.
- |Fix|
feature_extraction.text.strip_accents_unicodenow correctly
removes accents from strings that are in NFKD normalized form. 15100 by Daniel Grady <DGrady>.
- |Fix| Fixed a bug that caused
feature_extraction.DictVectorizerto raise
an OverflowError during the transform operation when producing a scipy.sparse matrix on large input data. 15463 by Norvan Sahiner <norvan>.
- |API| Deprecated unused
copyparam for
feature_extraction.text.TfidfVectorizer.transform it will be removed in v0.24. 14520 by Guillem G. Subies <guillemgsubies>.
sklearn.feature_selection ................................
- |Enhancement| Updated the following
sklearn.feature_selection
estimators to allow NaN/Inf values in `transform and fit: feature_selection.RFE, feature_selection.RFECV, feature_selection.SelectFromModel, and feature_selection.VarianceThreshold. Note that if the underlying estimator of the feature selector does not allow NaN/Inf then it will still error, but the feature selectors themselves no longer enforce this restriction unnecessarily. 11635 by Alec Peters <adpeters>`.
- |Fix| Fixed a bug where
feature_selection.VarianceThresholdwith
threshold=0 did not remove constant features due to numerical instability, by using range rather than variance in this case. 13704 by Roddy MacSween <rlms>.
sklearn.gaussian_process ...............................
- |Feature| Gaussian process models on structured data:
gaussian_process.GaussianProcessRegressor
and gaussian_process.GaussianProcessClassifier can now accept a list of generic objects (e.g. strings, trees, graphs, etc.) as the `X argument to their training/prediction methods. A user-defined kernel should be provided for computing the kernel matrix among the generic objects, and should inherit from gaussian_process.kernels.GenericKernelMixin to notify the GPR/GPC model that it handles non-vectorial samples. 15557 by Yu-Hang Tang <yhtang>`.
- |Efficiency|
gaussian_process.GaussianProcessClassifier.log_marginal_likelihood
and gaussian_process.GaussianProcessRegressor.log_marginal_likelihood now accept a `clone_kernel=True keyword argument. When set to False, the kernel attribute is modified, but may result in a performance improvement. 14378 by Masashi Shibata <c-bata>`.
- |API| From version 0.24
gaussian_process.kernels.Kernel.get_paramswill raise an
`AttributeError rather than return None for parameters that are in the estimator's constructor but not stored as attributes on the instance. 14464 by Joel Nothman`_.
sklearn.impute .....................
- |MajorFeature| Added
impute.KNNImputer, to impute missing values using
k-Nearest Neighbors. 12852 by Ashim Bhattarai <ashimb9> and Thomas Fan_ and 15010 by Guillaume Lemaitre_.
- |Feature|
impute.IterativeImputerhas newskip_computeflag that
is False by default, which, when True, will skip computation on features that have no missing values during the fit phase. 13773 by Sergey Feldman <sergeyf>.
- |Efficiency|
impute.MissingIndicator.fit_transformavoid repeated
computation of the masked matrix. 14356 by Harsh Soni <harsh020>.
- |Fix|
impute.IterativeImputernow works when there is only one feature.
By Sergey Feldman <sergeyf>.
- |Fix| Fixed a bug in
impute.IterativeImputerwhere features were
imputed in the reverse desired order with `imputation_order either "ascending" or "descending". 15393 by Venkatachalam N <venkyyuvy>`.
sklearn.inspection .........................
- |MajorFeature|
inspection.permutation_importancehas been added to
measure the importance of each feature in an arbitrary trained model with respect to a given scoring function. 13146 by Thomas Fan_.
- |Feature|
inspection.partial_dependenceand
inspection.plot_partial_dependence now support the fast 'recursion' method for ensemble.HistGradientBoostingClassifier and ensemble.HistGradientBoostingRegressor. 13769 by Nicolas Hug_.
- |Enhancement|
inspection.plot_partial_dependencehas been extended to
now support the new visualization API described in the :ref:User Guide <visualizations>. 14646 by Thomas Fan_.
- |Enhancement|
inspection.partial_dependenceaccepts pandas DataFrame
and pipeline.Pipeline containing compose.ColumnTransformer. In addition inspection.plot_partial_dependence will use the column names by default when a dataframe is passed. 14028 and 15429 by Guillaume Lemaitre_.
sklearn.kernel_approximation ...................................
- |Fix| Fixed a bug where
kernel_approximation.Nystroemraised a
KeyError when using kernel="precomputed". 14706 by Venkatachalam N <venkyyuvy>.
sklearn.linear_model ...........................
- |Efficiency| The 'liblinear' logistic regression solver is now faster and
requires less memory. 14108, 14170, 14296 by Alex Henrie <alexhenrie>.
- |Enhancement|
linear_model.BayesianRidgenow accepts hyperparameters
`alpha_init and lambda_init which can be used to set the initial value of the maximization procedure in fit. 13618 by Yoshihiro Uchida <c56pony>`.
- |Fix|
linear_model.Ridgenow correctly fits an intercept whenXis
sparse, solver="auto" and fit_intercept=True, because the default solver in this configuration has changed to sparse_cg, which can fit an intercept with sparse data. 13995 by Jérôme Dockès <jeromedockes>.
- |Fix|
linear_model.Ridgewithsolver='sag'now accepts F-ordered
and non-contiguous arrays and makes a conversion instead of failing. 14458 by Guillaume Lemaitre_.
- |Fix|
linear_model.LassoCVno longer forces `precompute=False`
when fitting the final model. 14591 by Andreas Müller_.
- |Fix|
linear_model.RidgeCVandlinear_model.RidgeClassifierCV
now correctly scores when cv=None. 14864 by Venkatachalam N <venkyyuvy>.
- |Fix| Fixed a bug in
linear_model.LogisticRegressionCVwhere the
`scores_, n_iter_ and coefs_paths_ attribute would have a wrong ordering with penalty='elastic-net'. 15044 by Nicolas Hug`_
- |Fix|
linear_model.MultiTaskLassoCVand
linear_model.MultiTaskElasticNetCV with X of dtype int and fit_intercept=True. 15086 by Alex Gramfort <agramfort>.
- |Fix| The liblinear solver now supports `
sample_weight`.
15038 by Guillaume Lemaitre_.
sklearn.manifold .......................
- |Feature|
manifold.Isomap,manifold.TSNE, and
manifold.SpectralEmbedding now accept precomputed sparse neighbors graph as input. 10482 by Tom Dupre la Tour_ and Kumar Ashutosh <thechargedneutron>.
- |Feature| Exposed the `
n_jobsparameter inmanifold.TSNE` for
multi-core calculation of the neighbors graph. This parameter has no impact when `metric="precomputed" or (metric="euclidean" and method="exact"). 15082 by Roman Yurchak`_.
- |Efficiency| Improved efficiency of
manifold.TSNEwhen
`method="barnes-hut" by computing the gradient in parallel. 13213 by Thomas Moreau <tommoral>`
- |Fix| Fixed a bug where
manifold.spectral_embedding(and therefore
manifold.SpectralEmbedding and cluster.SpectralClustering) computed wrong eigenvalues with `eigen_solver='amg' when n_samples < 5 * n_components. 14647 by Andreas Müller`_.
- |Fix| Fixed a bug in
manifold.spectral_embeddingused in
manifold.SpectralEmbedding and cluster.SpectralClustering where `eigen_solver="amg" would sometimes result in a LinAlgError. 13393 by Andrew Knyazev <lobpcg> 13707 by Scott White <whitews>`
- |API| Deprecate `
training_data_` unused attribute in
manifold.Isomap. 10482 by Tom Dupre la Tour_.
sklearn.metrics ......................
- |MajorFeature|
metrics.plot_roc_curvehas been added to plot roc
curves. This function introduces the visualization API described in the User Guide <visualizations>. 14357 by Thomas Fan_.
- |Feature| Added a new parameter `
zero_division` to multiple classification
metrics: metrics.precision_score, metrics.recall_score, metrics.f1_score, metrics.fbeta_score, metrics.precision_recall_fscore_support, metrics.classification_report. This allows to set returned value for ill-defined metrics. 14900 by Marc Torrellas Socastro <marctorrellas>.
- |Feature| Added the
metrics.pairwise.nan_euclidean_distancesmetric,
which calculates euclidean distances in the presence of missing values. 12852 by Ashim Bhattarai <ashimb9> and Thomas Fan_.
- |Feature| New ranking metrics
metrics.ndcg_scoreand
metrics.dcg_score have been added to compute Discounted Cumulative Gain and Normalized Discounted Cumulative Gain. 9951 by :user:Jérôme Dockès <jeromedockes>.
- |Feature|
metrics.plot_precision_recall_curvehas been added to plot
precision recall curves. 14936 by Thomas Fan_.
- |Feature|
metrics.plot_confusion_matrixhas been added to plot
confusion matrices. 15083 by Thomas Fan_.
- |Feature| Added multiclass support to
metrics.roc_auc_scorewith
corresponding scorers 'roc_auc_ovr', 'roc_auc_ovo', 'roc_auc_ovr_weighted', and 'roc_auc_ovo_weighted'. 12789 and 15274 by Kathy Chen <kathyxchen>, Mohamed Maskani <maskani-moh>, and Thomas Fan_.
- |Feature| Add
metrics.mean_tweedie_deviancemeasuring the
Tweedie deviance for a given `power parameter. Also add mean Poisson deviance metrics.mean_poisson_deviance and mean Gamma deviance metrics.mean_gamma_deviance that are special cases of the Tweedie deviance for power=1 and power=2 respectively. 13938 by Christian Lorentzen <lorentzenchr> and Roman Yurchak`_.
- |Efficiency| Improved performance of
metrics.pairwise.manhattan_distances in the case of sparse matrices. 15049 by Paolo Toccaceli <ptocca>.
- |Enhancement| The parameter `
betainmetrics.fbeta_score` is
updated to accept the zero and float('+inf') value. 13231 by Dong-hee Na <corona10>.
- |Enhancement| Added parameter `
squaredinmetrics.mean_squared_error`
to return root mean squared error. 13467 by Urvang Patel <urvang96>.
- |Enhancement| Allow computing averaged metrics in the case of no true positives.
14595 by Andreas Müller_.
- |Enhancement| Multilabel metrics now supports list of lists as input.
14865 Srivatsan Ramesh <srivatsan-ramesh>, Herilalaina Rakotoarison <herilalaina>, Léonard Binet <leonardbinet>.
- |Enhancement|
metrics.median_absolute_errornow supports
`multioutput parameter. 14732 by Agamemnon Krasoulis <agamemnonc>`.
- |Enhancement| 'roc_auc_ovr_weighted' and 'roc_auc_ovo_weighted' can now be
used as the scoring parameter of model-selection tools. 14417 by Thomas Fan_.
- |Enhancement|
metrics.confusion_matrixaccepts a parameters
normalize allowing to normalize the confusion matrix by column, rows, or overall. 15625 by Guillaume Lemaitre <glemaitre>.
- |Fix| Raise a ValueError in
metrics.silhouette_scorewhen a
precomputed distance matrix contains non-zero diagonal entries. 12258 by Stephen Tierney <sjtrny>.
- |API| `
scoring="neg_brier_score"` should be used instead of
`scoring="brier_score_loss" which is now deprecated. 14898 by Stefan Matcovici <stefan-matcovici>`.
sklearn.model_selection ..............................
- |Efficiency| Improved performance of multimetric scoring in
model_selection.cross_validate, model_selection.GridSearchCV, and model_selection.RandomizedSearchCV. 14593 by Thomas Fan_.
- |Enhancement|
model_selection.learning_curvenow accepts parameter
`return_times which can be used to retrieve computation times in order to plot model scalability (see learning_curve example). 13938 by Hadrien Reboul <H4dr1en>`.
- |Enhancement|
model_selection.RandomizedSearchCVnow accepts lists
of parameter distributions. 14549 by Andreas Müller_.
- |Fix| Reimplemented
model_selection.StratifiedKFoldto fix an issue
where one test set could be n_classes larger than another. Test sets should now be near-equally sized. 14704 by Joel Nothman_.
- |Fix| The
cv_results_attribute ofmodel_selection.GridSearchCV
and model_selection.RandomizedSearchCV now only contains unfitted estimators. This potentially saves a lot of memory since the state of the estimators isn't stored. #15096 by Andreas Müller_.
- |API|
model_selection.KFoldand
model_selection.StratifiedKFold now raise a warning if random_state is set but shuffle is False. This will raise an error in 0.24.
sklearn.multioutput ..........................
- |Fix|
multioutput.MultiOutputClassifiernow has attribute
`classes_. 14629 by Agamemnon Krasoulis <agamemnonc>`.
- |Fix|
multioutput.MultiOutputClassifiernow haspredict_proba
as property and can be checked with hasattr. 15488 15490 by Rebekah Kim <rebekahkim>
sklearn.naive_bayes ...............................
- |MajorFeature| Added
naive_bayes.CategoricalNBthat implements the
Categorical Naive Bayes classifier. 12569 by Tim Bicker <timbicker> and Florian Wilhelm <FlorianWilhelm>.
sklearn.neighbors ........................
- |MajorFeature| Added
neighbors.KNeighborsTransformerand
neighbors.RadiusNeighborsTransformer, which transform input dataset into a sparse neighbors graph. They give finer control on nearest neighbors computations and enable easy pipeline caching for multiple use. 10482 by Tom Dupre la Tour_.
- |Feature|
neighbors.KNeighborsClassifier,
neighbors.KNeighborsRegressor, neighbors.RadiusNeighborsClassifier, neighbors.RadiusNeighborsRegressor, and neighbors.LocalOutlierFactor now accept precomputed sparse neighbors graph as input. 10482 by Tom Dupre la Tour_ and Kumar Ashutosh <thechargedneutron>.
- |Feature|
neighbors.RadiusNeighborsClassifiernow supports
predicting probabilities by using predict_proba and supports more outlier_label options: 'most_frequent', or different outlier_labels for multi-outputs. 9597 by Wenbo Zhao <webber26232>.
- |Efficiency| Efficiency improvements for
neighbors.RadiusNeighborsClassifier.predict. 9597 by Wenbo Zhao <webber26232>.
- |Fix|
neighbors.KNeighborsRegressornow throws error when
metric='precomputed' and fit on non-square data. 14336 by Gregory Dexter <gdex1>.
sklearn.neural_network .............................
- |Feature| Add
max_funparameter in
neural_network.BaseMultilayerPerceptron, neural_network.MLPRegressor, and neural_network.MLPClassifier to give control over maximum number of function evaluation to not meet `tol improvement. 9274 by Daniel Perry <daniel-perry>`.
sklearn.pipeline .......................
- |Enhancement|
pipeline.Pipelinenow supportsscore_samplesif
the final estimator does. 13806 by Anaël Beaugnon <ab-anssi>.
- |Fix| The
fitin~pipeline.FeatureUnionnow acceptsfit_params
to pass to the underlying transformers. 15119 by Adrin Jalali_.
- |API|
Noneas a transformer is now deprecated in
pipeline.FeatureUnion. Please use 'drop' instead. 15053 by Thomas Fan_.
sklearn.preprocessing ............................
- |Efficiency|
preprocessing.PolynomialFeaturesis now faster when
the input data is dense. 13290 by Xavier Dupré <sdpython>.
- |Enhancement| Avoid unnecessary data copy when fitting preprocessors
preprocessing.StandardScaler, preprocessing.MinMaxScaler, preprocessing.MaxAbsScaler, preprocessing.RobustScaler and preprocessing.QuantileTransformer which results in a slight performance improvement. 13987 by Roman Yurchak_.
- |Fix| KernelCenterer now throws error when fit on non-square
preprocessing.KernelCenterer 14336 by Gregory Dexter <gdex1>.
sklearn.model_selection ..............................
- |Fix|
model_selection.GridSearchCVand
model_selection.RandomizedSearchCV now supports the _pairwise property, which prevents an error during cross-validation for estimators with pairwise inputs (such as neighbors.KNeighborsClassifier when metric is set to 'precomputed'). 13925 by Isaac S. Robson <isrobson> and 15524 by Xun Tang <xun-tang>.
sklearn.svm ..................
- |Enhancement|
svm.SVCandsvm.NuSVCnow accept a
`break_ties parameter. This parameter results in predict breaking the ties according to the confidence values of decision_function, if decision_function_shape='ovr', and the number of target classes > 2. 12557 by Adrin Jalali`_.
- |Enhancement| SVM estimators now throw a more specific error when
kernel='precomputed' and fit on non-square data. 14336 by Gregory Dexter <gdex1>.
- |Fix|
svm.SVC,svm.SVR,svm.NuSVRand
svm.OneClassSVM when received values negative or zero for parameter `sample_weight in method fit(), generated an invalid model. This behavior occurred only in some border scenarios. Now in these cases, fit() will fail with an Exception. 14286 by Alex Shacked <alexshacked>`.
- |Fix| The
n_support_attribute ofsvm.SVRand
svm.OneClassSVM was previously non-initialized, and had size 2. It has now size 1 with the correct value. 15099 by Nicolas Hug_.
- |Fix| fixed a bug in
BaseLibSVM._sparse_fitwhere n_SV=0 raised a
ZeroDivisionError. 14894 by Danna Naser <danna-naser>.
- |Fix| The liblinear solver now supports `
sample_weight`.
15038 by Guillaume Lemaitre_.
sklearn.tree ...................
- |Feature| Adds minimal cost complexity pruning, controlled by `
ccp_alpha`,
to tree.DecisionTreeClassifier, tree.DecisionTreeRegressor, tree.ExtraTreeClassifier, tree.ExtraTreeRegressor, ensemble.RandomForestClassifier, ensemble.RandomForestRegressor, ensemble.ExtraTreesClassifier, ensemble.ExtraTreesRegressor, ensemble.GradientBoostingClassifier, and ensemble.GradientBoostingRegressor. 12887 by Thomas Fan_.
- |API| `
presort` is now deprecated in
tree.DecisionTreeClassifier and tree.DecisionTreeRegressor, and the parameter has no effect. 14907 by Adrin Jalali_.
- |API| The `
classes_andn_classes_` attributes of
tree.DecisionTreeRegressor are now deprecated. 15028 by Mei Guan <meiguan>, Nicolas Hug_, and Adrin Jalali_.
sklearn.utils ....................
- |Feature|
~utils.estimator_checks.check_estimatorcan now generate
checks by setting generate_only=True. Previously, running ~utils.estimator_checks.check_estimator will stop when the first check fails. With generate_only=True, all checks can run independently and report the ones that are failing. Read more in rolling_your_own_estimator. 14381 by Thomas Fan_.
- |Feature| Added a pytest specific decorator,
~utils.estimator_checks.parametrize_with_checks, to parametrize estimator checks for a list of estimators. 14381 by Thomas Fan_.
- |Feature| A new random variable,
utils.fixes.loguniformimplements a
log-uniform random variable (e.g., for use in RandomizedSearchCV). For example, the outcomes `1, 10 and 100 are all equally likely for loguniform(1, 100). See 11232 by Scott Sievert <stsievert> and Nathaniel Saul <sauln>, and SciPy PR 10815 <https://github.com/scipy/scipy/pull/10815>`_.
- |Enhancement|
utils.safe_indexing(now deprecated) accepts an
`axis parameter to index array-like across rows and columns. The column indexing can be done on NumPy array, SciPy sparse matrix, and Pandas DataFrame. An additional refactoring was done. 14035 and 14475 by Guillaume Lemaitre`_.
- |Enhancement|
utils.extmath.safe_sparse_dotworks between 3D+ ndarray
and sparse matrix. 14538 by Jérémie du Boisberranger <jeremiedbb>.
- |Fix|
utils.check_arrayis now raising an error instead of casting
NaN to integer. 14872 by Roman Yurchak_.
- |Fix|
utils.check_arraywill now correctly detect numeric dtypes in
pandas dataframes, fixing a bug where `float32 was upcast to float64 unnecessarily. 15094 by Andreas Müller`_.
- |API| The following utils have been deprecated and are now private:
- `
choose_check_classifiers_labels` - `
enforce_estimator_tags_y` - `
mocking.MockDataFrame` - `
mocking.CheckingClassifier` - `
optimize.newton_cg` - `
random.random_choice_csc` - `
utils.choose_check_classifiers_labels` - `
utils.enforce_estimator_tags_y` - `
utils.optimize.newton_cg` - `
utils.random.random_choice_csc` - `
utils.safe_indexing` - `
utils.mocking` - `
utils.fast_dict` - `
utils.seq_dataset` - `
utils.weight_vector` - `
utils.fixes.parallel_helper` (removed) - All of `
utils.testingexcept forall_estimators` which is now in
`utils`.
sklearn.isotonic ..................................
- |Fix| Fixed a bug where
isotonic.IsotonicRegression.fitraised error
when X.dtype == 'float32' and X.dtype != y.dtype. 14902 by Lucas <lostcoaster>.
Miscellaneous .............
- |Fix| Port
lobpcgfrom SciPy which implement some bug fixes but only
available in 1.3+. 13609 and 14971 by Guillaume Lemaitre_.
- |API| Scikit-learn now converts any input data structure implementing a
duck array to a numpy array (using `__array__) to ensure consistent behavior instead of relying on __array_function__ (see NEP 18 <https://numpy.org/neps/nep-0018-array-function-protocol.html>_). 14702 by Andreas Müller`_.
- |API| Replace manual checks with `
check_is_fitted`. Errors thrown when
using a non-fitted estimators are now more uniform. 13013 by Agamemnon Krasoulis <agamemnonc>.
Changes to estimator checks
These changes mostly affect library developers.
- Estimators are now expected to raise a `
NotFittedErrorifpredict` or
`transform is called before fit; previously an AttributeError or ValueError was acceptable. 13013 by by Agamemnon Krasoulis <agamemnonc>`.
- Binary only classifiers are now supported in estimator checks.
Such classifiers need to have the binary_only=True estimator tag. 13875 by Trevor Stephens_.
- Estimators are expected to convert input data (`
X,y`,
`sample_weights) to numpy.ndarray and never call __array_function__ on the original datatype that is passed (see NEP 18 <https://numpy.org/neps/nep-0018-array-function-protocol.html>_). 14702 by Andreas Müller`_.
requires_positive_Xestimator tag (for models that require
X to be non-negative) is now used by utils.estimator_checks.check_estimator to make sure a proper error message is raised if X contains some negative entries. 14680 by Alex Gramfort <agramfort>.
- Added check that pairwise estimators raise error on non-square data
14336 by Gregory Dexter <gdex1>.
- Added two common multioutput estimator tests
utils.estimator_checks.check_classifier_multioutput and utils.estimator_checks.check_regressor_multioutput. 13392 by Rok Mihevc <rok>.
- |Fix| Added `
check_transformer_data_not_an_array` to checks where missing
- |Fix| The estimators tags resolution now follows the regular MRO. They used
to be overridable only once. 14884 by Andreas Müller_.
Thanks to everyone who has contributed to the maintenance and improvement of the project since version 0.21, including:
Aaron Alphonsus, Abbie Popa, Abdur-Rahmaan Janhangeer, abenbihi, Abhinav Sagar, Abhishek Jana, Abraham K. Lagat, Adam J. Stewart, Aditya Vyas, Adrin Jalali, Agamemnon Krasoulis, Alec Peters, Alessandro Surace, Alexandre de Siqueira, Alexandre Gramfort, alexgoryainov, Alex Henrie, Alex Itkes, alexshacked, Allen Akinkunle, Anaël Beaugnon, Anders Kaseorg, Andrea Maldonado, Andrea Navarrete, Andreas Mueller, Andreas Schuderer, Andrew Nystrom, Angela Ambroz, Anisha Keshavan, Ankit Jha, Antonio Gutierrez, Anuja Kelkar, Archana Alva, arnaudstiegler, arpanchowdhry, ashimb9, Ayomide Bamidele, Baran Buluttekin, barrycg, Bharat Raghunathan, Bill Mill, Biswadip Mandal, blackd0t, Brian G. Barkley, Brian Wignall, Bryan Yang, c56pony, camilaagw, cartman_nabana, catajara, Cat Chenal, Cathy, cgsavard, Charles Vesteghem, Chiara Marmo, Chris Gregory, Christian Lorentzen, Christos Aridas, Dakota Grusak, Daniel Grady, Daniel Perry, Danna Naser, DatenBergwerk, David Dormagen, deeplook, Dillon Niederhut, Dong-hee Na, Dougal J. Sutherland, DrGFreeman, Dylan Cashman, edvardlindelof, Eric Larson, Eric Ndirangu, Eunseop Jeong, Fanny, federicopisanu, Felix Divo, flaviomorelli, FranciDona, Franco M. Luque, Frank Hoang, Frederic Haase, g0g0gadget, Gabriel Altay, Gabriel do Vale Rios, Gael Varoquaux, ganevgv, gdex1, getgaurav2, Gideon Sonoiya, Gordon Chen, gpapadok, Greg Mogavero, Grzegorz Szpak, Guillaume Lemaitre, Guillem García Subies, H4dr1en, hadshirt, Hailey Nguyen, Hanmin Qin, Hannah Bruce Macdonald, Harsh Mahajan, Harsh Soni, Honglu Zhang, Hossein Pourbozorg, Ian Sanders, Ingrid Spielman, J-A16, jaehong park, Jaime Ferrando Huertas, James Hill, James Myatt, Jay, jeremiedbb, Jérémie du Boisberranger, jeromedockes, Jesper Dramsch, Joan Massich, Joanna Zhang, Joel Nothman, Johann Faouzi, Jonathan Rahn, Jon Cusick, Jose Ortiz, Kanika Sabharwal, Katarina Slama, kellycarmody, Kennedy Kang'ethe, Kensuke Arai, Kesshi Jordan, Kevad, Kevin Loftis, Kevin Winata, Kevin Yu-Sheng Li, Kirill Dolmatov, Kirthi Shankar Sivamani, krishna katyal, Lakshmi Krishnan, Lakshya KD, LalliAcqua, lbfin, Leland McInnes, Léonard Binet, Loic Esteve, loopyme, lostcoaster, Louis Huynh, lrjball, Luca Ionescu, Lutz Roeder, MaggieChege, Maithreyi Venkatesh, Maltimore, Maocx, Marc Torrellas, Marie Douriez, Markus, Markus Frey, Martina G. Vilas, Martin Oywa, Martin Thoma, Masashi SHIBATA, Maxwell Aladago, mbillingr, m-clare, Meghann Agarwal, m.fab, Micah Smith, miguelbarao, Miguel Cabrera, Mina Naghshhnejad, Ming Li, motmoti, mschaffenroth, mthorrell, Natasha Borders, nezar-a, Nicolas Hug, Nidhin Pattaniyil, Nikita Titov, Nishan Singh Mann, Nitya Mandyam, norvan, notmatthancock, novaya, nxorable, Oleg Stikhin, Oleksandr Pavlyk, Olivier Grisel, Omar Saleem, Owen Flanagan, panpiort8, Paolo, Paolo Toccaceli, Paresh Mathur, Paula, Peng Yu, Peter Marko, pierretallotte, poorna-kumar, pspachtholz, qdeffense, Rajat Garg, Raphaël Bournhonesque, Ray, Ray Bell, Rebekah Kim, Reza Gharibi, Richard Payne, Richard W, rlms, Robert Juergens, Rok Mihevc, Roman Feldbauer, Roman Yurchak, R Sanjabi, RuchitaGarde, Ruth Waithera, Sackey, Sam Dixon, Samesh Lakhotia, Samuel Taylor, Sarra Habchi, Scott Gigante, Scott Sievert, Scott White, Sebastian Pölsterl, Sergey Feldman, SeWook Oh, she-dares, Shreya V, Shubham Mehta, Shuzhe Xiao, SimonCW, smarie, smujjiga, Sönke Behrends, Soumirai, Sourav Singh, stefan-matcovici, steinfurt, Stéphane Couvreur, Stephan Tulkens, Stephen Cowley, Stephen Tierney, SylvainLan, th0rwas, theoptips, theotheo, Thierno Ibrahima DIOP, Thomas Edwards, Thomas J Fan, Thomas Moreau, Thomas Schmitt, Tilen Kusterle, Tim Bicker, Timsaur, Tim Staley, Tirth Patel, Tola A, Tom Augspurger, Tom Dupré la Tour, topisan, Trevor Stephens, ttang131, Urvang Patel, Vathsala Achar, veerlosar, Venkatachalam N, Victor Luzgin, Vincent Jeanselme, Vincent Lostanlen, Vladimir Korolev, vnherdeiro, Wenbo Zhao, Wendy Hu, willdarnell, William de Vazelhes, wolframalpha, xavier dupré, xcjason, x-martian, xsat, xun-tang, Yinglr, yokasre, Yu-Hang "Maxin" Tang, Yulia Zamriy, Zhao Feng