Skip to content

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Apr 20, 2023

  • GridHelperCurveLinear: numpydocify; remove unused _aux_trans attribute.
  • GridFinder: This class is used nowhere else but as attribute on GridHelperCurveLinear and could probably be inlined into it; for now, remove the duplicated constructor docstring.

PR Summary

PR Checklist

Documentation and Tests

  • Has pytest style unit tests (and pytest passes)
  • Documentation is sphinx and numpydoc compliant (the docs should build without error).
  • New plotting related features are documented with examples.

Release Notes

  • New features are marked with a .. versionadded:: directive in the docstring and documented in doc/users/next_whats_new/
  • API changes are marked with a .. versionchanged:: directive in the docstring and documented in doc/api/next_api_changes/
  • Release notes conform with instructions in next_whats_new/README.rst or next_api_changes/README.rst

Internal helper for `.GridHelperCurveLinear`, with the same constructor parameters;
should not be directly instantiated.
"""

def __init__(self,
transform,
Copy link
Member

Choose a reason for hiding this comment

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

Modify this to aux_trans for consistency (as this is the internal one, probably makes more sense to modify it here)?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I don't really want to bother going through a separate deprecation of the parameter name if we're going to fully inline GridFinder anyways. Plus, aux_trans is a pretty awkward name, if anything I actually prefer transform.

Comment on lines +248 to +254
extreme_finder

grid_locator1, grid_locator2
Grid locators for each axis.

tick_formatter1, tick_formatter2
Tick formatters for each axis.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
extreme_finder
grid_locator1, grid_locator2
Grid locators for each axis.
tick_formatter1, tick_formatter2
Tick formatters for each axis.
extreme_finder : optional
grid_locator1, grid_locator2 : Locator, optional
Grid locators for each axis.
tick_formatter1, tick_formatter2 : Formatter, optional
Tick formatters for each axis.

Not sure which class extreme_finder is. Bonus for proper links...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

They're not really locators and formatters though (but rather axisartist's variants on them).

Copy link
Member

@oscargus oscargus left a comment

Choose a reason for hiding this comment

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

Good idea and a step in the right direction. Some comments for a slightly longer step.

@oscargus oscargus added this to the v3.8.0 milestone Apr 20, 2023
- GridHelperCurveLinear: numpydocify; remove unused _aux_trans attribute.
- GridFinder: This class is used nowhere else but as attribute on
  GridHelperCurveLinear and could probably be inlined into it; for now,
  remove the duplicated constructor docstring.
@QuLogic QuLogic merged commit 8bb3100 into matplotlib:main Apr 21, 2023
@anntzer anntzer deleted the ghc branch April 22, 2023 08:08
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