Skip to content

DOC: replaced step with stairs in basic plot types - #26233

Merged
rcomer merged 1 commit into
matplotlib:mainfrom
rcomer:maria-stairs
Jul 2, 2023
Merged

rcomer merged 1 commit into
matplotlib:mainfrom
rcomer:maria-stairs

Conversation

@rcomer

@rcomer rcomer commented Jul 1, 2023

Copy link
Copy Markdown
Member

PR summary

Rebase of #25924 which seems to have stalled. I couldn't push directly to their branch - maybe because it's main? The git error was a bit cryptic.

Closes #25924, closes #22277. The original PR also linked #23204, though that discussion is rather more involved than just step vs stairs.

PR checklist

@rcomer

rcomer commented Jul 1, 2023

Copy link
Copy Markdown
Member Author

I should probably have looked at the plot before I pushed…

@rcomer
rcomer marked this pull request as draft July 1, 2023 15:37
@rcomer

rcomer commented Jul 1, 2023

Copy link
Copy Markdown
Member Author

Updated so it's more of a direct replacement for the step plot.

Plot from #25924:
image

Now:
image

@rcomer
rcomer marked this pull request as ready for review July 1, 2023 15:59
Co-authored-by: Maria Malykh <mmalykh@matplotlib-dev-srv.ru-central1.internal>

@story645 story645 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Great as is, but how do you feel about adding a little pointer to step too -
Kinda like how pcolormesh has a little descriptor https://matplotlib.org/devdocs/plot_types/arrays/pcolormesh.html#sphx-glr-plot-types-arrays-pcolormesh-py

@rcomer

rcomer commented Jul 2, 2023

Copy link
Copy Markdown
Member Author

I’m struggling to come up with words for what to say about step. I would want it to be something quite succinct like “If you want XYZ, use step”. The USP seems to be the where parameter, which I can understand by looking at the demo, but really not sure how to describe it.

@story645

story645 commented Jul 2, 2023

Copy link
Copy Markdown
Member

I think the note on that step demo is kinda the point - step if you know mids, stairs if you know edges. Also you're welcome to self merge w/o my note & I can put in a follow on.

@rcomer

rcomer commented Jul 2, 2023

Copy link
Copy Markdown
Member Author

Also you're welcome to self merge w/o my note & I can put in a follow on.

Thanks I think I’ll do that…

@rcomer rcomer added this to the v3.8.0 milestone Jul 2, 2023
@rcomer
rcomer merged commit eaad954 into matplotlib:main Jul 2, 2023
@rcomer
rcomer deleted the maria-stairs branch July 2, 2023 17:18
StefRe added a commit to StefRe/matplotlib that referenced this pull request Jul 6, 2023
by replacing step with stairs (follow-up to matplotlib#26233) and replacing
the second step entry with the fill_between basic plot
@StefRe StefRe mentioned this pull request Jul 6, 2023
1 task
@QuLogic QuLogic mentioned this pull request Aug 10, 2023
6 tasks
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.

[Doc]: Exchange step() for stairs() in the Plot types - Basic section

2 participants