Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

DOC: hexbin 'extent' must be 4-tuple of float, not float #20485

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 4 commits into from
Jun 23, 2021
Merged

DOC: hexbin 'extent' must be 4-tuple of float, not float #20485

merged 4 commits into from
Jun 23, 2021

Conversation

sappelhoff
Copy link
Contributor

PR Summary

In this PR I want to fix the docstring for the hexbin parameter extent:

extent : float, default: *None*

It previously said "float", but it actually wants a 4-tuple of floats, as evident from the code:

if extent is not None:
xmin, xmax, ymin, ymax = extent

PR Checklist

  • Has pytest style unit tests (and pytest passes).
  • Is Flake 8 compliant (run flake8 on changed files to check).
  • [N/A] New features are documented, with examples if plot related.
  • Documentation is sphinx and numpydoc compliant (the docs should build without error).
  • Conforms to Matplotlib style conventions (install flake8-docstrings and run flake8 --docstring-convention=all).
  • [N/A] New features have an entry in doc/users/next_whats_new/ (follow instructions in README.rst there).
  • [N/A] API changes documented in doc/api/next_api_changes/ (follow instructions in README.rst there).

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Thank you for opening your first PR into Matplotlib!

If you have not heard from us in a while, please feel free to ping @matplotlib/developers or anyone who has commented on the PR. Most of our reviewers are volunteers and sometimes things fall through the cracks.

You can also join us on gitter for real-time discussion.

For details on testing, writing docs, and our review process, please see the developer guide

We strive to be a welcoming and open project. Please follow our Code of Conduct.

Comment on lines 4651 to 4652
The limits of the bins. The default assigns the limits
based on *gridsize*, *x*, *y*, *xscale* and *yscale*.
Copy link
Member

@jklymak jklymak Jun 22, 2021

Choose a reason for hiding this comment

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

if you are fixing, this maybe be explicit since we have at least 4 different ways to assign extents in the library:

Suggested change
The limits of the bins. The default assigns the limits
based on *gridsize*, *x*, *y*, *xscale* and *yscale*.
The limits of the bins (xmin, xmax, ymin, ymax) . The default assigns the limits
based on *gridsize*, *x*, *y*, *xscale* and *yscale*.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

thanks, that makes sense. I probably violated some 79 char line width rule now by committing, right?

Copy link
Member

Choose a reason for hiding this comment

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

That's actually already there in the third paragraph. If we move it here, then that line can be deleted.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

thanks, removed in 569336b

Co-authored-by: Jody Klymak <jklymak@gmail.com>
@jklymak jklymak added this to the v3.5.0 milestone Jun 22, 2021
@jklymak
Copy link
Member

jklymak commented Jun 22, 2021

... sorry I should have been more careful in the diff - you need to make sure each line is not more than 79 characters.

@QuLogic QuLogic merged commit 6f92db0 into matplotlib:master Jun 23, 2021
@QuLogic
Copy link
Member

QuLogic commented Jun 23, 2021

Thanks @sappelhoff! Congratulations on your first PR to Matplotlib 🎉 We hope to hear from you again.

@sappelhoff
Copy link
Contributor Author

Thank you :-) I also hope to be of more help in the future!

@sappelhoff sappelhoff deleted the fix/docstr/hexbin branch June 23, 2021 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants
Morty Proxy This is a proxified and sanitized view of the page, visit original site.