Skip to content

CLN/DOC: add axis parameter doc for filter method #7197

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 22, 2014
Merged

CLN/DOC: add axis parameter doc for filter method #7197

merged 1 commit into from
May 22, 2014

Conversation

cpcloud
Copy link
Member

@cpcloud cpcloud commented May 21, 2014

removing some unused imports and added axis parameter doc for filter method

@cpcloud cpcloud added the Docs label May 21, 2014
@cpcloud cpcloud added this to the 0.14.1 milestone May 21, 2014
@cpcloud cpcloud self-assigned this May 21, 2014
@@ -1757,6 +1756,8 @@ def filter(self, items=None, like=None, regex=None, axis=None):
Keep info axis where "arg in col == True"
regex : string (regular expression)
Keep info axis with re.search(regex, col) == True
axis : int or None
The axis to filter on. By default this is the info axis
Copy link
Member

Choose a reason for hiding this comment

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

Good to add this!
Only, I personally think the expression info axis is not very clear what this means. That is never used in the docs (apart for a very few docstrings, like this)

Copy link
Member Author

Choose a reason for hiding this comment

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

I agree however I didn't want to launch into the reasoning behind this. Maybe we can add a section at the top of the API docs about this?

Copy link
Member Author

Choose a reason for hiding this comment

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

@jorisvandenbossche I can add something to the FAQ, if that would be helpful.

Copy link
Contributor

Choose a reason for hiding this comment

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

you can also just say that this is the [] index, e.g. DataFrame=1,Series=0,Panel=0

Copy link
Contributor

Choose a reason for hiding this comment

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

you can put this in 0.14.0

@jreback jreback modified the milestones: 0.14.0, 0.14.1 May 21, 2014
cpcloud added a commit that referenced this pull request May 22, 2014
CLN/DOC: add axis parameter doc for filter method
@cpcloud cpcloud merged commit 7e45b34 into pandas-dev:master May 22, 2014
@cpcloud cpcloud deleted the filter-axis-doc branch May 22, 2014 00:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants