1.1. Generalized Linear Models¶
The following are a set of methods intended for regression in which the target value is expected to be a linear combination of the input variables. In mathematical notion, if is the predicted value.
Across the module, we designate the vector as coef_ and as intercept_.
To perform classification with generalized linear models, see Logistic regression.
1.1.1. Ordinary Least Squares¶
LinearRegression fits a linear model with coefficients to minimize the residual sum of squares between the observed responses in the dataset, and the responses predicted by the linear approximation. Mathematically it solves a problem of the form:
LinearRegression will take in its fit method arrays X, y and will store the coefficients of the linear model in its coef_ member:
>>> from sklearn import linear_model
>>> clf = linear_model.LinearRegression()
>>> clf.fit ([[0, 0], [1, 1], [2, 2]], [0, 1, 2])
LinearRegression(copy_X=True, fit_intercept=True, n_jobs=1, normalize=False)
>>> clf.coef_
array([ 0.5, 0.5])
However, coefficient estimates for Ordinary Least Squares rely on the independence of the model terms. When terms are correlated and the columns of the design matrix have an approximate linear dependence, the design matrix becomes close to singular and as a result, the leastsquares estimate becomes highly sensitive to random errors in the observed response, producing a large variance. This situation of multicollinearity can arise, for example, when data are collected without an experimental design.
Examples:
1.1.1.1. Ordinary Least Squares Complexity¶
This method computes the least squares solution using a singular value decomposition of X. If X is a matrix of size (n, p) this method has a cost of , assuming that .
1.1.2. Ridge Regression¶
Ridge regression addresses some of the problems of Ordinary Least Squares by imposing a penalty on the size of coefficients. The ridge coefficients minimize a penalized residual sum of squares,
Here, is a complexity parameter that controls the amount of shrinkage: the larger the value of , the greater the amount of shrinkage and thus the coefficients become more robust to collinearity.
As with other linear models, Ridge will take in its fit method arrays X, y and will store the coefficients of the linear model in its coef_ member:
>>> from sklearn import linear_model
>>> clf = linear_model.Ridge (alpha = .5)
>>> clf.fit ([[0, 0], [0, 0], [1, 1]], [0, .1, 1])
Ridge(alpha=0.5, copy_X=True, fit_intercept=True, max_iter=None,
normalize=False, random_state=None, solver='auto', tol=0.001)
>>> clf.coef_
array([ 0.34545455, 0.34545455])
>>> clf.intercept_
0.13636...
Examples:
1.1.2.1. Ridge Complexity¶
This method has the same order of complexity than an Ordinary Least Squares.
1.1.2.2. Setting the regularization parameter: generalized CrossValidation¶
RidgeCV implements ridge regression with builtin crossvalidation of the alpha parameter. The object works in the same way as GridSearchCV except that it defaults to Generalized CrossValidation (GCV), an efficient form of leaveoneout crossvalidation:
>>> from sklearn import linear_model
>>> clf = linear_model.RidgeCV(alphas=[0.1, 1.0, 10.0])
>>> clf.fit([[0, 0], [0, 0], [1, 1]], [0, .1, 1])
RidgeCV(alphas=[0.1, 1.0, 10.0], cv=None, fit_intercept=True, scoring=None,
normalize=False)
>>> clf.alpha_
0.1
References
 “Notes on Regularized Least Squares”, Rifkin & Lippert (technical report, course slides).
1.1.3. Lasso¶
The Lasso is a linear model that estimates sparse coefficients. It is useful in some contexts due to its tendency to prefer solutions with fewer parameter values, effectively reducing the number of variables upon which the given solution is dependent. For this reason, the Lasso and its variants are fundamental to the field of compressed sensing. Under certain conditions, it can recover the exact set of nonzero weights (see Compressive sensing: tomography reconstruction with L1 prior (Lasso)).
Mathematically, it consists of a linear model trained with prior as regularizer. The objective function to minimize is:
The lasso estimate thus solves the minimization of the leastsquares penalty with added, where is a constant and is the norm of the parameter vector.
The implementation in the class Lasso uses coordinate descent as the algorithm to fit the coefficients. See Least Angle Regression for another implementation:
>>> from sklearn import linear_model
>>> clf = linear_model.Lasso(alpha = 0.1)
>>> clf.fit([[0, 0], [1, 1]], [0, 1])
Lasso(alpha=0.1, copy_X=True, fit_intercept=True, max_iter=1000,
normalize=False, positive=False, precompute=False, random_state=None,
selection='cyclic', tol=0.0001, warm_start=False)
>>> clf.predict([[1, 1]])
array([ 0.8])
Also useful for lowerlevel tasks is the function lasso_path that computes the coefficients along the full path of possible values.
Examples:
Note
Feature selection with Lasso
As the Lasso regression yields sparse models, it can thus be used to perform feature selection, as detailed in L1based feature selection.
Note
Randomized sparsity
For feature selection or sparse recovery, it may be interesting to use Randomized sparse models.
1.1.3.1. Setting regularization parameter¶
The alpha parameter controls the degree of sparsity of the coefficients estimated.
1.1.3.1.1. Using crossvalidation¶
scikitlearn exposes objects that set the Lasso alpha parameter by crossvalidation: LassoCV and LassoLarsCV. LassoLarsCV is based on the Least Angle Regression algorithm explained below.
For highdimensional datasets with many collinear regressors, LassoCV is most often preferable. However, LassoLarsCV has the advantage of exploring more relevant values of alpha parameter, and if the number of samples is very small compared to the number of observations, it is often faster than LassoCV.
1.1.3.1.2. Informationcriteria based model selection¶
Alternatively, the estimator LassoLarsIC proposes to use the Akaike information criterion (AIC) and the Bayes Information criterion (BIC). It is a computationally cheaper alternative to find the optimal value of alpha as the regularization path is computed only once instead of k+1 times when using kfold crossvalidation. However, such criteria needs a proper estimation of the degrees of freedom of the solution, are derived for large samples (asymptotic results) and assume the model is correct, i.e. that the data are actually generated by this model. They also tend to break when the problem is badly conditioned (more features than samples).
1.1.4. Elastic Net¶
ElasticNet is a linear regression model trained with L1 and L2 prior as regularizer. This combination allows for learning a sparse model where few of the weights are nonzero like Lasso, while still maintaining the regularization properties of Ridge. We control the convex combination of L1 and L2 using the l1_ratio parameter.
Elasticnet is useful when there are multiple features which are correlated with one another. Lasso is likely to pick one of these at random, while elasticnet is likely to pick both.
A practical advantage of tradingoff between Lasso and Ridge is it allows ElasticNet to inherit some of Ridge’s stability under rotation.
The objective function to minimize is in this case
The class ElasticNetCV can be used to set the parameters alpha () and l1_ratio () by crossvalidation.
1.1.5. Multitask Lasso¶
The MultiTaskLasso is a linear model that estimates sparse coefficients for multiple regression problems jointly: y is a 2D array, of shape (n_samples, n_tasks). The constraint is that the selected features are the same for all the regression problems, also called tasks.
The following figure compares the location of the nonzeros in W obtained with a simple Lasso or a MultiTaskLasso. The Lasso estimates yields scattered nonzeros while the nonzeros of the MultiTaskLasso are full columns.
Fitting a timeseries model, imposing that any active feature be active at all times.
Mathematically, it consists of a linear model trained with a mixed prior as regularizer. The objective function to minimize is:
where;
The implementation in the class MultiTaskLasso uses coordinate descent as the algorithm to fit the coefficients.
1.1.6. Least Angle Regression¶
Leastangle regression (LARS) is a regression algorithm for highdimensional data, developed by Bradley Efron, Trevor Hastie, Iain Johnstone and Robert Tibshirani.
The advantages of LARS are:
 It is numerically efficient in contexts where p >> n (i.e., when the number of dimensions is significantly greater than the number of points)
 It is computationally just as fast as forward selection and has the same order of complexity as an ordinary least squares.
 It produces a full piecewise linear solution path, which is useful in crossvalidation or similar attempts to tune the model.
 If two variables are almost equally correlated with the response, then their coefficients should increase at approximately the same rate. The algorithm thus behaves as intuition would expect, and also is more stable.
 It is easily modified to produce solutions for other estimators, like the Lasso.
The disadvantages of the LARS method include:
 Because LARS is based upon an iterative refitting of the residuals, it would appear to be especially sensitive to the effects of noise. This problem is discussed in detail by Weisberg in the discussion section of the Efron et al. (2004) Annals of Statistics article.
The LARS model can be used using estimator Lars, or its lowlevel implementation lars_path.
1.1.7. LARS Lasso¶
LassoLars is a lasso model implemented using the LARS algorithm, and unlike the implementation based on coordinate_descent, this yields the exact solution, which is piecewise linear as a function of the norm of its coefficients.
>>> from sklearn import linear_model
>>> clf = linear_model.LassoLars(alpha=.1)
>>> clf.fit([[0, 0], [1, 1]], [0, 1])
LassoLars(alpha=0.1, copy_X=True, eps=..., fit_intercept=True,
fit_path=True, max_iter=500, normalize=True, positive=False,
precompute='auto', verbose=False)
>>> clf.coef_
array([ 0.717157..., 0. ])
Examples:
The Lars algorithm provides the full path of the coefficients along the regularization parameter almost for free, thus a common operation consist of retrieving the path with function lars_path
1.1.7.1. Mathematical formulation¶
The algorithm is similar to forward stepwise regression, but instead of including variables at each step, the estimated parameters are increased in a direction equiangular to each one’s correlations with the residual.
Instead of giving a vector result, the LARS solution consists of a curve denoting the solution for each value of the L1 norm of the parameter vector. The full coefficients path is stored in the array coef_path_, which has size (n_features, max_features+1). The first column is always zero.
References:
 Original Algorithm is detailed in the paper Least Angle Regression by Hastie et al.
1.1.8. Orthogonal Matching Pursuit (OMP)¶
OrthogonalMatchingPursuit and orthogonal_mp implements the OMP algorithm for approximating the fit of a linear model with constraints imposed on the number of nonzero coefficients (ie. the L _{0} pseudonorm).
Being a forward feature selection method like Least Angle Regression, orthogonal matching pursuit can approximate the optimum solution vector with a fixed number of nonzero elements:
Alternatively, orthogonal matching pursuit can target a specific error instead of a specific number of nonzero coefficients. This can be expressed as:
OMP is based on a greedy algorithm that includes at each step the atom most highly correlated with the current residual. It is similar to the simpler matching pursuit (MP) method, but better in that at each iteration, the residual is recomputed using an orthogonal projection on the space of the previously chosen dictionary elements.
Examples:
References:
1.1.9. Bayesian Regression¶
Bayesian regression techniques can be used to include regularization parameters in the estimation procedure: the regularization parameter is not set in a hard sense but tuned to the data at hand.
This can be done by introducing uninformative priors over the hyper parameters of the model. The regularization used in Ridge Regression is equivalent to finding a maximum apostiori solution under a Gaussian prior over the parameters with precision . Instead of setting lambda manually, it is possible to treat it as a random variable to be estimated from the data.
To obtain a fully probabilistic model, the output is assumed to be Gaussian distributed around :
Alpha is again treated as a random variable that is to be estimated from the data.
The advantages of Bayesian Regression are:
 It adapts to the data at hand.
 It can be used to include regularization parameters in the estimation procedure.
The disadvantages of Bayesian regression include:
 Inference of the model can be time consuming.
References
 A good introduction to Bayesian methods is given in C. Bishop: Pattern Recognition and Machine learning
 Original Algorithm is detailed in the book Bayesian learning for neural networks by Radford M. Neal
1.1.9.1. Bayesian Ridge Regression¶
BayesianRidge estimates a probabilistic model of the regression problem as described above. The prior for the parameter is given by a spherical Gaussian:
The priors over and are chosen to be gamma distributions, the conjugate prior for the precision of the Gaussian.
The resulting model is called Bayesian Ridge Regression, and is similar to the classical Ridge. The parameters , and are estimated jointly during the fit of the model. The remaining hyperparameters are the parameters of the gamma priors over and . These are usually chosen to be noninformative. The parameters are estimated by maximizing the marginal log likelihood.
By default .
Bayesian Ridge Regression is used for regression:
>>> from sklearn import linear_model
>>> X = [[0., 0.], [1., 1.], [2., 2.], [3., 3.]]
>>> Y = [0., 1., 2., 3.]
>>> clf = linear_model.BayesianRidge()
>>> clf.fit(X, Y)
BayesianRidge(alpha_1=1e06, alpha_2=1e06, compute_score=False, copy_X=True,
fit_intercept=True, lambda_1=1e06, lambda_2=1e06, n_iter=300,
normalize=False, tol=0.001, verbose=False)
After being fitted, the model can then be used to predict new values:
>>> clf.predict ([[1, 0.]])
array([ 0.50000013])
The weights of the model can be access:
>>> clf.coef_
array([ 0.49999993, 0.49999993])
Due to the Bayesian framework, the weights found are slightly different to the ones found by Ordinary Least Squares. However, Bayesian Ridge Regression is more robust to illposed problem.
Examples:
References
 More details can be found in the article Bayesian Interpolation by MacKay, David J. C.
1.1.9.2. Automatic Relevance Determination  ARD¶
ARDRegression is very similar to Bayesian Ridge Regression, but can lead to sparser weights [1] [2]. ARDRegression poses a different prior over , by dropping the assumption of the Gaussian being spherical.
Instead, the distribution over is assumed to be an axisparallel, elliptical Gaussian distribution.
This means each weight is drawn from a Gaussian distribution, centered on zero and with a precision :
with .
In contrast to Bayesian Ridge Regression, each coordinate of has its own standard deviation . The prior over all is chosen to be the same gamma distribution given by hyperparameters and .
References:
[1]  Christopher M. Bishop: Pattern Recognition and Machine Learning, Chapter 7.2.1 
[2]  David Wipf and Srikantan Nagarajan: A new view of automatic relevance determination. 
1.1.10. Logistic regression¶
Logistic regression, despite its name, is a linear model for classification rather than regression. Logistic regression is also known in the literature as logit regression, maximumentropy classification (MaxEnt) or the loglinear classifier. In this model, the probabilities describing the possible outcomes of a single trial are modeled using a logistic function.
The implementation of logistic regression in scikitlearn can be accessed from class LogisticRegression. This implementation can fit a multiclass (onevsrest) logistic regression with optional L2 or L1 regularization.
As an optimization problem, binary class L2 penalized logistic regression minimizes the following cost function:
Similarly, L1 regularized logistic regression solves the following optimization problem
The solvers implemented in the class LogisticRegression are “liblinear” (which is a wrapper around the C++ library, LIBLINEAR), “newtoncg”, “lbfgs” and “sag”.
The “lbfgs” and “newtoncg” solvers only support L2 penalization and are found to converge faster for some high dimensional data. L1 penalization yields sparse predicting weights.
The solver “liblinear” uses a coordinate descent (CD) algorithm based on Liblinear. For L1 penalization sklearn.svm.l1_min_c allows to calculate the lower bound for C in order to get a non “null” (all feature weights to zero) model. This relies on the excellent LIBLINEAR library, which is shipped with scikitlearn. However, the CD algorithm implemented in liblinear cannot learn a true multinomial (multiclass) model; instead, the optimization problem is decomposed in a “onevsrest” fashion so separate binary classifiers are trained for all classes. This happens under the hood, so LogisticRegression instances using this solver behave as multiclass classifiers.
Setting multi_class to “multinomial” with the “lbfgs” or “newtoncg” solver in LogisticRegression learns a true multinomial logistic regression model, which means that its probability estimates should be better calibrated than the default “onevsrest” setting. “lbfgs”, “newtoncg” and “sag” solvers cannot optimize L1penalized models, though, so the “multinomial” setting does not learn sparse models.
The solver “sag” uses a Stochastic Average Gradient descent [3]. It does not handle “multinomial” case, and is limited to L2penalized models, yet it is often faster than other solvers for large datasets, when both the number of samples and the number of features are large.
In a nutshell, one may choose the solver with the following rules:
Case  Solver 

Small dataset or L1 penalty  “liblinear” 
Multinomial loss  “lbfgs” or newtoncg” 
Large dataset  “sag” 
For large dataset, you may also consider using SGDClassifier with ‘log’ loss.
Differences from liblinear:
There might be a difference in the scores obtained between LogisticRegression with solver=liblinear or LinearSVC and the external liblinear library directly, when fit_intercept=False and the fit coef_ (or) the data to be predicted are zeroes. This is because for the sample(s) with decision_function zero, LogisticRegression and LinearSVC predict the negative class, while liblinear predicts the positive class. Note that a model with fit_intercept=False and having many samples with decision_function zero, is likely to be a underfit, bad model and you are advised to set fit_intercept=True and increase the intercept_scaling.
Note
Feature selection with sparse logistic regression
A logistic regression with L1 penalty yields sparse models, and can thus be used to perform feature selection, as detailed in L1based feature selection.
LogisticRegressionCV implements Logistic Regression with builtin crossvalidation to find out the optimal C parameter. “newtoncg”, “sag” and “lbfgs” solvers are found to be faster for highdimensional dense data, due to warmstarting. For the multiclass case, if multi_class option is set to “ovr”, an optimal C is obtained for each class and if the multi_class option is set to “multinomial”, an optimal C is obtained that minimizes the crossentropy loss.
References:
[3]  Mark Schmidt, Nicolas Le Roux, and Francis Bach: Minimizing Finite Sums with the Stochastic Average Gradient. 
1.1.11. Stochastic Gradient Descent  SGD¶
Stochastic gradient descent is a simple yet very efficient approach to fit linear models. It is particularly useful when the number of samples (and the number of features) is very large. The partial_fit method allows only/outofcore learning.
The classes SGDClassifier and SGDRegressor provide functionality to fit linear models for classification and regression using different (convex) loss functions and different penalties. E.g., with loss="log", SGDClassifier fits a logistic regression model, while with loss="hinge" it fits a linear support vector machine (SVM).
References
1.1.12. Perceptron¶
The Perceptron is another simple algorithm suitable for large scale learning. By default:
 It does not require a learning rate.
 It is not regularized (penalized).
 It updates its model only on mistakes.
The last characteristic implies that the Perceptron is slightly faster to train than SGD with the hinge loss and that the resulting models are sparser.
1.1.13. Passive Aggressive Algorithms¶
The passiveaggressive algorithms are a family of algorithms for largescale learning. They are similar to the Perceptron in that they do not require a learning rate. However, contrary to the Perceptron, they include a regularization parameter C.
For classification, PassiveAggressiveClassifier can be used with loss='hinge' (PAI) or loss='squared_hinge' (PAII). For regression, PassiveAggressiveRegressor can be used with loss='epsilon_insensitive' (PAI) or loss='squared_epsilon_insensitive' (PAII).
References:
 “Online PassiveAggressive Algorithms” K. Crammer, O. Dekel, J. Keshat, S. ShalevShwartz, Y. Singer  JMLR 7 (2006)
1.1.14. Robustness regression: outliers and modeling errors¶
Robust regression is interested in fitting a regression model in the presence of corrupt data: either outliers, or error in the model.
1.1.14.1. Different scenario and useful concepts¶
There are different things to keep in mind when dealing with data corrupted by outliers:
Outliers in X or in y?
Outliers in the y direction Outliers in the X direction Fraction of outliers versus amplitude of error
The number of outlying points matters, but also how much they are outliers.
Small outliers Large outliers
An important notion of robust fitting is that of breakdown point: the fraction of data that can be outlying for the fit to start missing the inlying data.
Note that in general, robust fitting in highdimensional setting (large n_features) is very hard. The robust models here will probably not work in these settings.
1.1.14.2. RANSAC: RANdom SAmple Consensus¶
RANSAC (RANdom SAmple Consensus) fits a model from random subsets of inliers from the complete data set.
RANSAC is a nondeterministic algorithm producing only a reasonable result with a certain probability, which is dependent on the number of iterations (see max_trials parameter). It is typically used for linear and nonlinear regression problems and is especially popular in the fields of photogrammetric computer vision.
The algorithm splits the complete input sample data into a set of inliers, which may be subject to noise, and outliers, which are e.g. caused by erroneous measurements or invalid hypotheses about the data. The resulting model is then estimated only from the determined inliers.
1.1.14.2.1. Details of the algorithm¶
Each iteration performs the following steps:
 Select min_samples random samples from the original data and check whether the set of data is valid (see is_data_valid).
 Fit a model to the random subset (base_estimator.fit) and check whether the estimated model is valid (see is_model_valid).
 Classify all data as inliers or outliers by calculating the residuals to the estimated model (base_estimator.predict(X)  y)  all data samples with absolute residuals smaller than the residual_threshold are considered as inliers.
 Save fitted model as best model if number of inlier samples is maximal. In case the current estimated model has the same number of inliers, it is only considered as the best model if it has better score.
These steps are performed either a maximum number of times (max_trials) or until one of the special stop criteria are met (see stop_n_inliers and stop_score). The final model is estimated using all inlier samples (consensus set) of the previously determined best model.
The is_data_valid and is_model_valid functions allow to identify and reject degenerate combinations of random subsamples. If the estimated model is not needed for identifying degenerate cases, is_data_valid should be used as it is called prior to fitting the model and thus leading to better computational performance.
References:
 http://en.wikipedia.org/wiki/RANSAC
 “Random Sample Consensus: A Paradigm for Model Fitting with Applications to Image Analysis and Automated Cartography” Martin A. Fischler and Robert C. Bolles  SRI International (1981)
 “Performance Evaluation of RANSAC Family” Sunglok Choi, Taemin Kim and Wonpil Yu  BMVC (2009)
1.1.14.3. TheilSen estimator: generalizedmedianbased estimator¶
The TheilSenRegressor estimator uses a generalization of the median in multiple dimensions. It is thus robust to multivariate outliers. Note however that the robustness of the estimator decreases quickly with the dimensionality of the problem. It looses its robustness properties and becomes no better than an ordinary least squares in high dimension.
1.1.14.3.1. Theoretical considerations¶
TheilSenRegressor is comparable to the Ordinary Least Squares (OLS) in terms of asymptotic efficiency and as an unbiased estimator. In contrast to OLS, TheilSen is a nonparametric method which means it makes no assumption about the underlying distribution of the data. Since TheilSen is a medianbased estimator, it is more robust against corrupted data aka outliers. In univariate setting, TheilSen has a breakdown point of about 29.3% in case of a simple linear regression which means that it can tolerate arbitrary corrupted data of up to 29.3%.
The implementation of TheilSenRegressor in scikitlearn follows a generalization to a multivariate linear regression model [4] using the spatial median which is a generalization of the median to multiple dimensions [5].
In terms of time and space complexity, TheilSen scales according to
which makes it infeasible to be applied exhaustively to problems with a large number of samples and features. Therefore, the magnitude of a subpopulation can be chosen to limit the time and space complexity by considering only a random subset of all possible combinations.
Examples:
References:
[4]  Xin Dang, Hanxiang Peng, Xueqin Wang and Heping Zhang: TheilSen Estimators in a Multiple Linear Regression Model. 
[5] 

1.1.15. Polynomial regression: extending linear models with basis functions¶
One common pattern within machine learning is to use linear models trained on nonlinear functions of the data. This approach maintains the generally fast performance of linear methods, while allowing them to fit a much wider range of data.
For example, a simple linear regression can be extended by constructing polynomial features from the coefficients. In the standard linear regression case, you might have a model that looks like this for twodimensional data:
If we want to fit a paraboloid to the data instead of a plane, we can combine the features in secondorder polynomials, so that the model looks like this:
The (sometimes surprising) observation is that this is still a linear model: to see this, imagine creating a new variable
With this relabeling of the data, our problem can be written
We see that the resulting polynomial regression is in the same class of linear models we’d considered above (i.e. the model is linear in ) and can be solved by the same techniques. By considering linear fits within a higherdimensional space built with these basis functions, the model has the flexibility to fit a much broader range of data.
Here is an example of applying this idea to onedimensional data, using polynomial features of varying degrees:
This figure is created using the PolynomialFeatures preprocessor. This preprocessor transforms an input data matrix into a new data matrix of a given degree. It can be used as follows:
>>> from sklearn.preprocessing import PolynomialFeatures
>>> import numpy as np
>>> X = np.arange(6).reshape(3, 2)
>>> X
array([[0, 1],
[2, 3],
[4, 5]])
>>> poly = PolynomialFeatures(degree=2)
>>> poly.fit_transform(X)
array([[ 1., 0., 1., 0., 0., 1.],
[ 1., 2., 3., 4., 6., 9.],
[ 1., 4., 5., 16., 20., 25.]])
The features of X have been transformed from to , and can now be used within any linear model.
This sort of preprocessing can be streamlined with the Pipeline tools. A single object representing a simple polynomial regression can be created and used as follows:
>>> from sklearn.preprocessing import PolynomialFeatures
>>> from sklearn.linear_model import LinearRegression
>>> from sklearn.pipeline import Pipeline
>>> import numpy as np
>>> model = Pipeline([('poly', PolynomialFeatures(degree=3)),
... ('linear', LinearRegression(fit_intercept=False))])
>>> # fit to an order3 polynomial data
>>> x = np.arange(5)
>>> y = 3  2 * x + x ** 2  x ** 3
>>> model = model.fit(x[:, np.newaxis], y)
>>> model.named_steps['linear'].coef_
array([ 3., 2., 1., 1.])
The linear model trained on polynomial features is able to exactly recover the input polynomial coefficients.
In some cases it’s not necessary to include higher powers of any single feature, but only the socalled interaction features that multiply together at most distinct features. These can be gotten from PolynomialFeatures with the setting interaction_only=True.
For example, when dealing with boolean features, for all and is therefore useless; but represents the conjunction of two booleans. This way, we can solve the XOR problem with a linear classifier:
>>> from sklearn.linear_model import Perceptron
>>> from sklearn.preprocessing import PolynomialFeatures
>>> import numpy as np
>>> X = np.array([[0, 0], [0, 1], [1, 0], [1, 1]])
>>> y = X[:, 0] ^ X[:, 1]
>>> X = PolynomialFeatures(interaction_only=True).fit_transform(X)
>>> X
array([[ 1., 0., 0., 0.],
[ 1., 0., 1., 0.],
[ 1., 1., 0., 0.],
[ 1., 1., 1., 1.]])
>>> clf = Perceptron(fit_intercept=False, n_iter=10, shuffle=False).fit(X, y)
>>> clf.score(X, y)
1.0