Movatterモバイル変換


[0]ホーム

URL:


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

Sign up
Appearance settings

Use (float, float) as parameter type for 2D positions#12227

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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged

Conversation

timhoffm
Copy link
Member

@timhoffmtimhoffm commentedSep 23, 2018
edited
Loading

PR Summary

As noted in#12214, we currently do not have a consistent way of defining the parameter type of 2D positions. Used formats include

  • tuple
  • iterable
  • tuple of 2 floats
  • (float, float)
  • tuple of (float, float)

While all are sort of correct, I think it's important to define the length and the element type.

A fully precise definition isiterable of float of length 2 orlength-2 iterable of float, which is IMO is not quite readable and scary to less experienced programmers.

Therefore, I propose to use(float, float), e.g.

        xy : (float, float)            The point *(x,y)* to annotate.

This seems simple and clear enough. It concisely defines contained type and size, and does not put emphasis on tuple, which is technically too restrictive as other iterables work as well.

@QuLogic
Copy link
Member

Are there any 3D positions that could benefit from this same style?

@jklymakjklymak merged commitda2aece intomatplotlib:masterSep 23, 2018
@jklymakjklymak added this to thev3.0.0-doc milestoneSep 23, 2018
@jklymak
Copy link
Member

@meeseeksdev backport to v3.0.0-doc

meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull requestSep 23, 2018
@timhoffmtimhoffm deleted the doc-parameter-types-pos branchSeptember 23, 2018 15:30
@QuLogicQuLogic changed the titleUse (float, float) as paramter type for 2D positionsUse (float, float) as parameter type for 2D positionsApr 18, 2020
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Reviewers

@dopplershiftdopplershiftdopplershift approved these changes

@anntzeranntzeranntzer approved these changes

@jklymakjklymakjklymak approved these changes

Assignees
No one assigned
Projects
None yet
Milestone
v3.0.0-doc
Development

Successfully merging this pull request may close these issues.

5 participants
@timhoffm@QuLogic@jklymak@dopplershift@anntzer

[8]ページ先頭

©2009-2025 Movatter.jp