FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

changes for MEP12/sphinx-gallery compliance by yinleon · Pull Request #8209 · matplotlib/matplotlib · GitHub

Repository navigation

changes for MEP12/sphinx-gallery compliance - #8209

Closed
yinleon wants to merge 4 commits into
matplotlib:masterfrom
yinleon:master
Closed

yinleon wants to merge 4 commits into
matplotlib:masterfrom
yinleon:master

Conversation

yinleon commented Mar 7, 2017

Copy link
Copy Markdown
Contributor

Regarding #7206

tacaswell added this to the 2.0.1 (next bug fix release) milestone Mar 7, 2017
Comment thread examples/event_handling/poly_editor.py Outdated
"""
===========
Poly Editor
==========

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

missing '='

Comment thread examples/event_handling/resample.py Outdated
self.origYData = ydata
self.origXData = xdata
self.ratio = 5
self.ratio = 50

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

This seems a bit too aggressive.

Copy link
Copy Markdown
Member

Left 2 small comments, but otherwise looks good!

Copy link
Copy Markdown
Member

In the future, it is better to make PRs against some branch other than your master branch.

yinleon commented Mar 7, 2017

Copy link
Copy Markdown
Contributor Author

@tacaswell will do! My first commit to an OSS project, so apologies.

ax.axis[direction].set_visible(True)

for direction in ["left", "right", "bottom", "top"]:
# hides boarders

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

boarders -> borders

Comment thread examples/event_handling/pipong.py Outdated
PONG
====

A matplotlib based game of Pong illustrating one way to write interactive animation which are easily ported to multiple backends pipong.py was written by Paul Ivanov <http://pirsquared.org>

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

matplotlib -> Matplotlib
animation -> animations
Add period at end of sentence.

Also, please wrap this line at 79 characters.

Comment thread examples/event_handling/resample.py Outdated
Resampling Data
===============

Downsampling lowers the sample rate or sample size of a signal. In this tutorial, the signal is downsampled when the plot is adjusted through dragging and zooming.

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Wrap this line.

Demonstrate the mixing of 2d and 3d subplots.
============================================
Demonstrate the mixing of 2d and 3d subplots
============================================

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Missing blank line after, I think.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

I think I resolved this?

Comment thread examples/pylab_examples/bar_stacked.py Outdated
=================

This is an example of creating a stacked bar plot with error bars using `plt.bar`.
Note the parameters `yerr` used for error bars, and `bottom` to stack the women's bars on top of the men's bars.

QuLogic Mar 7, 2017 •
edited
Loading

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Lines need to be wrapped.

Comment thread examples/pylab_examples/dolphin.py Outdated
@@ -1,3 +1,11 @@
"""
=======
Dophins

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Dophins -> Dolphins

Comment thread examples/pylab_examples/dolphin.py Outdated
Dophins
=======

This example shows how to draw, and manipulate shapes given verticies and nodes using the patches, path and transforms classes.

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Wrap line.

Filling the area between lines
==============================

This example shows how to use fill_between() to color between lines based on user-defined logic.

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Wrap line.

Comment thread examples/pylab_examples/geo_demo.py Outdated
======================

This shows 4 possible projections using subplot.
Matplotlib also supports the <a href='http://matplotlib.org/basemap/'>Basemaps Toolkit</a> for geographic projections.

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Wrap line. Probably should mention Cartopy as well.

Comment thread examples/pylab_examples/mri_demo.py Outdated
MRI
===

This example illustrates how to read an image (of an MRI) into a numpy array, and display it in greyscale using `ax.imshow`.

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

numpy -> NumPy

Wrap line.

ax.axis[direction].set_visible(True)

for direction in ["left", "right", "bottom", "top"]:
# hides boarders

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

borders

Comment thread examples/event_handling/pipong.py Outdated
# pipong.py was written by Paul Ivanov <http://pirsquared.org>
"""
====
PONG

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

"Pong" (I don't think it should be all caps).

Comment thread examples/pylab_examples/dolphin.py Outdated
@@ -1,3 +1,11 @@
"""
=======
Dophins

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

dolphins

@@ -1,3 +1,10 @@
"""
================
Axis Line Styles

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Looks like most already converted examples only capitalize the first word (which I prefer too), so let's stay consistent (applies to this and all files below).

Demonstrate the mixing of 2d and 3d subplots.
============================================
Demonstrate the mixing of 2d and 3d subplots
============================================

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

blank line

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

I think I resolved this?

Comment thread examples/event_handling/pipong.py Outdated
PONG
====

A matplotlib based game of Pong illustrating one way to write interactive animation which are easily ported to multiple backends pipong.py was written by Paul Ivanov <http://pirsquared.org>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Here and below, wrap your lines at 79 characters (most editors should provide some option to help that).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Here and below, use the rst syntax for hyperlinks (http://www.sphinx-doc.org/en/stable/rest.html#hyperlinks).

Filling the area between lines
==============================

This example shows how to use fill_between() to color between lines based on user-defined logic.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality
`fill_between`

(with backquotes) -- ultimately this should create a link to the API docs.

Comment thread examples/pylab_examples/dolphin.py Outdated
Dophins
=======

This example shows how to draw, and manipulate shapes given verticies and nodes using the patches, path and transforms classes.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

"vertices".

Please spell-check your docstrings.

Comment thread examples/pylab_examples/mri_demo.py Outdated
MRI
===

This example illustrates how to read an image (of an MRI) into a numpy array, and display it in greyscale using `ax.imshow`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

just imshow

anntzer commented Mar 7, 2017

Copy link
Copy Markdown
Contributor

Apparently I reviewed this at the same time as @QuLogic :-)

Copy link
Copy Markdown
Member

Apparently other reviewer can spell better than I can..

yinleon commented Mar 7, 2017

Copy link
Copy Markdown
Contributor Author

thanks @anntzer and @QuLogic, you two are equally thorough :)


A Matplotlib based game of Pong illustrating one way to write interactive
animations which are easily ported to multiple backends pipong.py was written
by <a href='http://pirsquared.org'>Paul Ivanov</a>.

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

I am somewhat not surprised by the original author of that example…
ping @ivanov :D

yinleon commented Mar 7, 2017

Copy link
Copy Markdown
Contributor Author

should I be alarmed about the Travis CLI failure? Now sure I understand what I'm seeing under Details.

Comment thread examples/event_handling/pipong.py Outdated
Pong
====

A Matplotlib based game of Pong illustrating one way to write interactive

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Beware of the trailing whitespace (remove it for PEP8-compliance)

Comment thread examples/event_handling/pipong.py Outdated
====

A Matplotlib based game of Pong illustrating one way to write interactive
animations which are easily ported to multiple backends pipong.py was written

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

As above, just remove the trailing whitespace for PEP8-compliance

afvincent commented Mar 7, 2017 •
edited
Loading

Copy link
Copy Markdown
Contributor

The Travis failure is related to PEP8 (more precisely to two trailing whitespaces). More details here ;).

Edit: typo

QuLogic commented Mar 7, 2017

Copy link
Copy Markdown
Member

If you have changes to multiple files, editing on GitHub is not a good choice. It creates way too many single commits of one or two minor changes. Please rebase and squash this on your local copy if you can.

NelleV commented Mar 8, 2017 •
edited
Loading

Copy link
Copy Markdown
Member

Can we activate the squash and merge option? This would allow us to squash and merge before merging instead of asking contributors to rebase themselves.

ping @tacaswell

QuLogic commented Mar 8, 2017 •
edited
Loading

Copy link
Copy Markdown
Member

TBH, as a contributor, I don't really like squash&merge as it decouples your fork and upstream's (I don't like rebase&merge for the same reason.)

yinleon commented Mar 8, 2017

Copy link
Copy Markdown
Contributor Author

Hi, I squashed all 20 commits. Did I do it correctly? Is it reflected in this PR, or should I make a new one?

NelleV commented Mar 8, 2017

Copy link
Copy Markdown
Member

Yep, it is done and it works! Thanks!

NelleV changed the title changes for MEP12/sphinx-gallery compliance [MRG+] changes for MEP12/sphinx-gallery compliance Mar 8, 2017
NelleV changed the title [MRG+] changes for MEP12/sphinx-gallery compliance [MRG+1] changes for MEP12/sphinx-gallery compliance Mar 8, 2017

NelleV 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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

LGTM 👍

QuLogic commented Mar 8, 2017 •
edited
Loading

Copy link
Copy Markdown
Member

Hi, I squashed all 20 commits. Did I do it correctly? Is it reflected in this PR, or should I make a new one?

No, it's not quite right. After rebasing, you need to force push the result. If you don't force, git will complain and suggest you pull everything, but that will restore all the previous commits locally and add another merge commit.

So, please do the rebase, and then do git push --force origin master (btw, it's safer to use a feature branch instead of master) so that you can replace all the old commits.

NelleV commented Mar 8, 2017

Copy link
Copy Markdown
Member

@yinleon Are you still around Berkeley? I was mistaken and something didn't quite happen right with the rebase. I am happy to help you out with this tomorrow (I should be at BIDS all afternoon if you are around).

yinleon commented Mar 8, 2017

Copy link
Copy Markdown
Contributor Author

Sure thing @QuLogic.
@NelleV yes-- I will be at BIDS tomorrow.
Sorry for the confusion all.

for direction in ["xzero", "yzero"]:
# adds arrows at the ends of each axis
ax.axis[direction].set_axisline_style("-|>")

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

There is some whitespace here causing the pep8 failure.

NelleV commented Mar 10, 2017

Copy link
Copy Markdown
Member

Hi @yinleon
There was a small blank line issue, that I fixed.

This patch needs an additional review.

NelleV added the MEP: MEP12 gallery and examples improvements label Mar 11, 2017

QuLogic 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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

LGTM, but can you amend this last typo, @NelleV?

Comment thread examples/event_handling/poly_editor.py Outdated
matplotlib event handling to interact with objects on the canvas
===========
Poly Editor
==========

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

One missing =.

NelleV changed the title [MRG+1] changes for MEP12/sphinx-gallery compliance [MRG+2] changes for MEP12/sphinx-gallery compliance Mar 12, 2017

NelleV commented Mar 16, 2017

Copy link
Copy Markdown
Member

I think this is ready to be merged. @anntzer can you have a look at this?

====

A Matplotlib based game of Pong illustrating one way to write interactive
animations which are easily ported to multiple backends pipong.py was written

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

dot after "multiple backends"


A Matplotlib based game of Pong illustrating one way to write interactive
animations which are easily ported to multiple backends pipong.py was written
by <a href='http://pirsquared.org'>Paul Ivanov</a>.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality


This is an example of plotting Edward Lorenz's 1963 "Deterministic
Nonperiodic Flow" in a 3-dimensional space using mplot3d.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

I would suggest using an explicit hyperlink target (http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-targets).

=================

This is an example of creating a stacked bar plot with error bars using
`plt.bar`. Note the parameters `yerr` used for error bars, and `bottom`

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

yerr and bottom should use *foo*, not backticks (they are not references to linkable elements).

========

This example shows how to draw, and manipulate shapes given vertices and nodes
using the `patches`, `path` and `transforms` classes.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Patch, Path, and Transform (references to actual python names).


This shows 4 possible projections using subplot.
Matplotlib also supports
<a href='http://matplotlib.org/basemap/'>Basemaps Toolkit</a> and

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

same comment as above regarding hyperlink syntax (either way works).

dstansby self-assigned this Apr 12, 2017

Copy link
Copy Markdown
Member

This is going to take a bit of a rebase now sphinx-gallery is merged. I've assigned this to myself and will try to do it in the next day or so.

Copy link
Copy Markdown
Contributor

hey @yinleon , a lot has changed with MPL docs in the last few weeks :)

This means it'll be a bit more complicated to get this merged. Do you have time to do a live skype where you and I can spot-check these issues and get it back to a mergeable state?

dstansby commented May 1, 2017

Copy link
Copy Markdown
Member

So I actually had a go at rebasing this last night, and gave up after a while. Quite a lot of the changes have already been made (titles), and there's only a couple of things that are now new unfortunately.

I think the easiest thing to do here would be to manually compare the PR diff and the current files, and just copy across anything new.

Copy link
Copy Markdown
Contributor

@phobson I think that's a good idea - let's see if @yinleon is interested in finishing this up and then we can make a plan from there

QuLogic modified the milestones: 2.0.1 (next bug fix release), 2.0.2 (next bug fix release) May 3, 2017
tacaswell mentioned this pull request Jul 10, 2017

Copy link
Copy Markdown
Member

Closing in favor of #8860

tacaswell closed this Jul 10, 2017
QuLogic modified the milestones: 2.1 (next point release), 2.0.3 (next bug fix release) Jul 15, 2017
QuLogic changed the title [MRG+2] changes for MEP12/sphinx-gallery compliance changes for MEP12/sphinx-gallery compliance Jul 15, 2017
dstansby removed their assignment Jul 31, 2017
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation MEP: MEP12 gallery and examples improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants


Back | FazBrowse Home | New Git URL