On Wed, Dec 12, 2012 at 11:57 AM, Marcel Oliver <m.oliver@jacobs-university.de> wrote:
Paul Hobson writes:
 > On Wed, Dec 12, 2012 at 5:59 AM, Michael Droettboom <mdroe@stsci.edu> wrote:
 >
 >     http://matplotlib.org/examples/api/clippath_demo.html
 >
 >     It's perfectly reasonable code, but seems strange that it's
 >     clipped off to the corner which I think makes it less useful as
 >     an example.
 >
 > If I understand correctly, you're proposing that that such an
 > example would be deleted after a more practical example was
 > available to replace it?
 >
 > While I'm 100% in favor of "cleaning out the closet", I used this exact
 > example two days ago to clip a depressed groundwater surface to a landfill
 > boundary :)

There is one small issue with the example: If one is using imshow on
random pixel data, there is not reason to use bilinear interpolation
(which is what imshow defaults to).  "nearest" is the only reasonable
choice.

I know this sounds pedantic, but it irks me as a numerical analyst...

--Marcel

Marcel: I agree examples like this should be changed. Actually, I think the default interpolation should be changed to "nearest", but that's a whole different can of worms ;)

For those who are interested, I just posted a pull request for this gallery clean up. It's definitely a work in progress. In particular, the section names are less than ideal, but I think github's PR interface is a better place for that discussion than the wiki or mailing list. The new section names can be found below:

https://github.com/matplotlib/matplotlib/pull/1623/files#L0R86

Also, I moved a number of examples to the new sections in order to demonstrate some of the clean up guidelines. BTW, one of the examples I cleaned up is the clippath demo discussed earlier in this thread.

Best,
-Tony

Marcel: Sorry for the second email, I forgot to "reply all" the first time.