sklearn_extra.robust
.RobustWeightedClassifier¶

class
sklearn_extra.robust.
RobustWeightedClassifier
(weighting='huber', max_iter=100, burn_in=10, eta0=0.01, c=None, k=0, loss='log', sgd_args=None, multi_class='ovr', n_jobs=1, tol=0.001, n_iter_no_change=10, verbose=0, random_state=None)[source]¶ Algorithm for robust classification using reweighting algorithm.
This model uses iterative reweighting of samples to make a regression or classification estimator robust.
The principle of the algorithm is to use an empirical risk minimization principle where the risk is estimated using a robust estimator (for example Huber estimator or medianofmeans estimator)[1], [3]. The idea behind this algorithm was mentioned before in [2]. This idea translates in an iterative algorithm where the sample_weight are changed at each iterations and are dependent of the sample. Informally the outliers should have small weight while the inliers should have big weight, where outliers are sample with a big loss function.
This algorithm enjoy a nonzero breakdownpoint (it can handle arbitrarily bad outliers). When the “mom” weighting scheme is used, k outliers can be tolerated. When the “Huber” weighting scheme is used, asymptotically the number of outliers has to be less than half the sample size.
Read more in the User Guide.
 Parameters
 weightingstring, default=”huber”
Weighting scheme used to make the estimator robust. Can be ‘huber’ for hubertype weights or ‘mom’ for medianofmeans type weights.
 max_iterint, default=100
Maximum number of iterations. For more information, see the optimization scheme of base_estimator and the eta0 and burn_in parameter.
 burn_inint, default=10
Number of steps used without changing the learning rate. Can be useful to make the weight estimation better at the beginning.
 eta0float, default=0.01
Constant stepsize used during the burn_in period. Used only if burn_in>0. Can have a big effect on efficiency.
 cfloat>0 or None, default=None
Parameter used for Huber weighting procedure, used only if weightings is ‘huber’. Measure the robustness of the weighting procedure. A small value of c means a more robust estimator. Can have a big effect on efficiency. If None, c is estimated at each step using half the Interquartile range, this tends to be conservative (robust).
 kint < sample_size/2, default=1
Parameter used for mom weighting procedure, used only if weightings is ‘mom’. 2k+1 is the number of blocks used for medianofmeans estimation, higher value of k means a more robust estimator. Can have a big effect on efficiency. If None, k is estimated using the number of points distant from the median of means of more than 2 times a robust estimate of the scale (using the interquartile range), this tends to be conservative (robust).
 lossstring, None or callable, default=”log”
Classification losses supported : ‘log’, ‘hinge’, ‘modified_huber’. If ‘log’, then the base_estimator must support predict_proba.
 sgd_argsdict, default={}
arguments of the SGDClassifier base estimator.
 multi_classstring, default=”ovr”
multiclass scheme. Can be either “ovo” for OneVsOneClassifier or “ovr” for OneVsRestClassifier or “binary” for binary classification.
 n_jobsint, default=1
number of jobs used in the multiclass metaalgorithm computation.
 tolfloat or None, (default = 1e3)
The stopping criterion. If it is not None, training will stop when (loss > best_loss  tol) for n_iter_no_change consecutive epochs.
 n_iter_no_changeint, default=10
Number of iterations with no improvement to wait before early stopping.
 verbose: int, default=0
If >0 will display the (robust) estimated loss every 10 epochs.
 random_stateint, RandomState instance or None, optional (default=None)
The seed of the pseudo random number generator to use when shuffling the data. If int, random_state is the seed used by the random number generator; If RandomState instance, random_state is the random number generator; If None, the random number generator is the RandomState instance used by np.random.
Notes
Often, there is a need to use RobustScaler as preprocessing.
References
 [1] Guillaume Lecué, Matthieu Lerasle and Timothée Mathieu.
“Robust classification via MOM minimization”, Mach Learn 109, (2020). https://doi.org/10.1007/s10994019058636 (2018). arXiv:1808.03106
 [2] Christian Brownlees, Emilien Joly and Gábor Lugosi.
“Empirical risk minimization for heavytailed losses”, Ann. Statist. Volume 43, Number 6 (2015), 25072536.
 [3] Stanislav Minsker and Timothée Mathieu.
“Excess risk bounds in robust empirical risk minimization” arXiv preprint (2019). arXiv:1910.07485.
Examples
>>> from sklearn_extra.robust import RobustWeightedClassifier >>> from sklearn.datasets import make_blobs >>> import numpy as np >>> rng = np.random.RandomState(42) >>> X,y = make_blobs(n_samples=100, centers=np.array([[1, 1], [1, 1]]), ... random_state=rng) >>> clf=RobustWeightedClassifier() >>> _ = clf.fit(X, y) >>> score = np.mean(clf.predict(X)==y)
 Attributes
 classes_ndarray of shape (n_classes, )
A list of class labels known to the classifier.
 coef_ndarray of shape (1, n_features) or (n_classes, n_features)
Coefficient of the features in the decision function. Only available if multi_class = “binary”
 intercept_ndarray of shape (1,) or (n_classes,)
Intercept (a.k.a. bias) added to the decision function. Only available if multi_class = “binary”
 n_iter_ndarray of shape (n_classes,) or (1, )
Actual number of iterations for all classes. If binary or multinomial, it returns only 1 element. For liblinear solver, only the maximum number of iteration across all classes is given.
 base_estimator_object,
The fitted base estimator SGDCLassifier.
 weights_array like, length = n_sample.
Weight of each sample at the end of the algorithm. Can be used as a measure of how much of an outlier a sample is. Only available if multi_class = “binary”