Clarify RobustScaler behavior with sparse input

naoyak · naoyak · commit 064168b03a3e · 2017-05-11T01:53:30.000-07:00
diff --git a/doc/modules/preprocessing.rst b/doc/modules/preprocessing.rst
@@ -191,7 +191,7 @@ matrices  as input, as long as ``with_mean=False`` is explicitly passed
 to the constructor. Otherwise a ``ValueError`` will be raised as
 silently centering would break the sparsity and would often crash the
 execution by allocating excessive amounts of memory unintentionally.
-:class:`RobustScaler` cannot be fited to sparse inputs, but you can use
+:class:`RobustScaler` cannot be fitted to sparse inputs, but you can use
 the ``transform`` method on sparse inputs.
 
 Note that the scalers accept both Compressed Sparse Rows and Compressed
diff --git a/sklearn/preprocessing/data.py b/sklearn/preprocessing/data.py
@@ -844,9 +844,9 @@ class RobustScaler(BaseEstimator, TransformerMixin):
     and the 3rd quartile (75th quantile).
 
     Centering and scaling happen independently on each feature (or each
-    sample, depending on the `axis` argument) by computing the relevant
+    sample, depending on the ``axis`` argument) by computing the relevant
     statistics on the samples in the training set. Median and  interquartile
-    range are then stored to be used on later data using the `transform`
+    range are then stored to be used on later data using the ``transform``
     method.
 
     Standardization of a dataset is a common requirement for many
@@ -863,7 +863,7 @@ class RobustScaler(BaseEstimator, TransformerMixin):
     ----------
     with_centering : boolean, True by default
         If True, center the data before scaling.
-        This does not work (and will raise an exception) when attempted on
+        This will cause ``transform`` to raise an exception when attempted on
         sparse matrices, because centering them entails building a dense
         matrix which in common use cases is likely to be too large to fit in
         memory.
@@ -930,7 +930,8 @@ def _check_array(self, X, copy):
         return X
 
     def fit(self, X, y=None):
-        """Compute the median and quantiles to be used for scaling.
+        """Compute the median and quantiles to be used for scaling. Note that
+        RobustScaler cannot be fitted to sparse inputs.
 
         Parameters
         ----------
