Skip to content

Fixing parameter description (for assume_centered)#13456

Merged
agramfort merged 3 commits intoscikit-learn:masterfrom
falaktheoptimist:patch-1
Apr 17, 2019
Merged

Fixing parameter description (for assume_centered)#13456
agramfort merged 3 commits intoscikit-learn:masterfrom
falaktheoptimist:patch-1

Conversation

@falaktheoptimist
Copy link
Copy Markdown
Contributor

Fixing parameter description (for the parameter assume_centered) and some minor grammatical errors.

Fixing parameter description (for assume_centered)
@adrinjalali
Copy link
Copy Markdown
Member

They don't look like errors to me though.

@jnothman
Copy link
Copy Markdown
Member

jnothman commented Mar 17, 2019 via email

@adrinjalali
Copy link
Copy Markdown
Member

+1

@falaktheoptimist
Copy link
Copy Markdown
Contributor Author

👍 Updated according to your suggestion

Copy link
Copy Markdown
Member

@adrinjalali adrinjalali left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

@qinhanmin2014 qinhanmin2014 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please update empirical_covariance_.py accordingly

@qinhanmin2014
Copy link
Copy Markdown
Member

I've changed my mind here. I don't think "will be centered" and "will not be centered" is appropriate, because sometimes (e.g., ShrunkCovariance), we simply use a different method to estimate the covariance when the data is assumed to be centered. Maybe use something like "the input data is assumed to be centered"?

Copy link
Copy Markdown
Member

@jnothman jnothman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are several other instances of the same parameter description, and we should change all together:

$ git grep -p -A2 assume_centered.:
sklearn/covariance/elliptic_envelope.py=class EllipticEnvelope(MinCovDet, OutlierMixin):
--
sklearn/covariance/elliptic_envelope.py:    assume_centered : boolean, optional (default=False)
sklearn/covariance/elliptic_envelope.py-        If True, the support of robust location and covariance estimates
sklearn/covariance/elliptic_envelope.py-        is computed, and a covariance estimate is recomputed from it,
--
sklearn/covariance/empirical_covariance_.py=def empirical_covariance(X, assume_centered=False):
--
sklearn/covariance/empirical_covariance_.py:    assume_centered : boolean
sklearn/covariance/empirical_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/empirical_covariance_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/empirical_covariance_.py=class EmpiricalCovariance(BaseEstimator):
--
sklearn/covariance/empirical_covariance_.py:    assume_centered : bool
sklearn/covariance/empirical_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/empirical_covariance_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/graph_lasso_.py=class GraphicalLasso(EmpiricalCovariance):
--
sklearn/covariance/graph_lasso_.py:    assume_centered : boolean, default False
sklearn/covariance/graph_lasso_.py-        If True, data are not centered before computation.
sklearn/covariance/graph_lasso_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/graph_lasso_.py=class GraphicalLassoCV(GraphicalLasso):
--
sklearn/covariance/graph_lasso_.py:    assume_centered : boolean
sklearn/covariance/graph_lasso_.py-        If True, data are not centered before computation.
sklearn/covariance/graph_lasso_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/graph_lasso_.py=class GraphLasso(GraphicalLasso):
--
sklearn/covariance/graph_lasso_.py:    assume_centered : boolean, default False
sklearn/covariance/graph_lasso_.py-        If True, data are not centered before computation.
sklearn/covariance/graph_lasso_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/graph_lasso_.py=class GraphLassoCV(GraphicalLassoCV):
--
sklearn/covariance/graph_lasso_.py:    assume_centered : Boolean
sklearn/covariance/graph_lasso_.py-        If True, data are not centered before computation.
sklearn/covariance/graph_lasso_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/robust_covariance.py=class MinCovDet(EmpiricalCovariance):
--
sklearn/covariance/robust_covariance.py:    assume_centered : bool
sklearn/covariance/robust_covariance.py-        If True, the support of the robust location and the covariance
sklearn/covariance/robust_covariance.py-        estimates is computed, and a covariance estimate is recomputed from
--
sklearn/covariance/shrunk_covariance_.py=class ShrunkCovariance(EmpiricalCovariance):
--
sklearn/covariance/shrunk_covariance_.py:    assume_centered : boolean, default False
sklearn/covariance/shrunk_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/shrunk_covariance_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/shrunk_covariance_.py=def ledoit_wolf_shrinkage(X, assume_centered=False, block_size=1000):
--
sklearn/covariance/shrunk_covariance_.py:    assume_centered : bool
sklearn/covariance/shrunk_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/shrunk_covariance_.py-        Useful to work with data whose mean is significantly equal to
--
sklearn/covariance/shrunk_covariance_.py=def ledoit_wolf(X, assume_centered=False, block_size=1000):
--
sklearn/covariance/shrunk_covariance_.py:    assume_centered : boolean, default=False
sklearn/covariance/shrunk_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/shrunk_covariance_.py-        Useful to work with data whose mean is significantly equal to
--
sklearn/covariance/shrunk_covariance_.py=class LedoitWolf(EmpiricalCovariance):
--
sklearn/covariance/shrunk_covariance_.py:    assume_centered : bool, default=False
sklearn/covariance/shrunk_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/shrunk_covariance_.py-        Useful when working with data whose mean is almost, but not exactly
--
sklearn/covariance/shrunk_covariance_.py=def oas(X, assume_centered=False):
--
sklearn/covariance/shrunk_covariance_.py:    assume_centered : boolean
sklearn/covariance/shrunk_covariance_.py-      If True, data are not centered before computation.
sklearn/covariance/shrunk_covariance_.py-      Useful to work with data whose mean is significantly equal to
--
sklearn/covariance/shrunk_covariance_.py=class OAS(EmpiricalCovariance):
--
sklearn/covariance/shrunk_covariance_.py:    assume_centered : bool, default=False
sklearn/covariance/shrunk_covariance_.py-        If True, data are not centered before computation.
sklearn/covariance/shrunk_covariance_.py-        Useful when working with data whose mean is almost, but not exactly

@jnothman
Copy link
Copy Markdown
Member

I'd not yet seen your comments, @qinhanmin2014 , sorry for any duplication.

@falaktheoptimist
Copy link
Copy Markdown
Contributor Author

If you let me know the comment text we want to go with, I'll make the changes in all files @jnothman pointed out above. I feel that something like assumes that the input data is centred explains it best.

@jnothman
Copy link
Copy Markdown
Member

jnothman commented Mar 19, 2019 via email

@falaktheoptimist
Copy link
Copy Markdown
Contributor Author

falaktheoptimist commented Mar 20, 2019

How about
If True, data is assumed to be centered and mean is not subtracted.
Useful when working with data whose mean is almost, but not exactly zero.
If False, data is assumed to be non-centered and mean is subtracted.

@agramfort agramfort merged commit 7243cc3 into scikit-learn:master Apr 17, 2019
jeremiedbb pushed a commit to jeremiedbb/scikit-learn that referenced this pull request Apr 25, 2019
* Fixing parameter description (for assume_centered)

Fixing parameter description (for assume_centered)

* Update shrunk_covariance_.py

* Update empirical_covariance_.py
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
* Fixing parameter description (for assume_centered)

Fixing parameter description (for assume_centered)

* Update shrunk_covariance_.py

* Update empirical_covariance_.py
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
koenvandevelde pushed a commit to koenvandevelde/scikit-learn that referenced this pull request Jul 12, 2019
* Fixing parameter description (for assume_centered)

Fixing parameter description (for assume_centered)

* Update shrunk_covariance_.py

* Update empirical_covariance_.py
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants