matplotlib Code

2008-09-14 Reorganized cbook and mlab methods related to numerical
calculations that have little to do with the goals of those two
modules into a separate module numerical_methods.py
Also, added ability to select points and stop point selection
with keyboard in ginput and manual contour labeling code.
Finally, fixed contour labeling bug. - DMK

* Moved several function in mlab.py and cbook.py into a separate module
numerical_methods.py because they were unrelated to the initial purpose of
mlab or cbook and appeared more coherent elsewhere.

Minor changes in response to comments by John Hunter on empty lists in python
args and avoiding unspecified argument lists.

Merged revisions 5834 via svnmerge from
https://matplotlib.svn.sourceforge.net/svnroot/matplotlib/branches/v0_91_maint

........
r5834 | jdh2358 | 2008-07-24 08:15:23 -0500 (Thu, 24 Jul 2008) | 1 line

deprecated mlab2 functions from mlab
........

Moving "event loop" stuff from blocking_input.py to backends. For backends
without a GUI, the default is to throw a NotImplemented error. For backends
with a GUI, I have implemented a "start/stop_event_loop_default" that does
the default event loop using time.sleep. For WX, I have used the code
supplied by Paul Kienzle, but I have been unable to check it because that
backend currently doesn't work for me.

Committing rewrite of clabel inlining and label rotation code. Also, renaming
ContourLabeler attributes to something like .labelAttribute. A few of the old
attribute names have been maintained (in addition to new versions) for
backward compatibility, but these should be remove in +1 releases.

Added appropriate comments to CHANGELOG and API_CHANGES.

Recommitting my changes to clabel to allow for manual labeling after fixing
problems with indexing identified by Eric Firing on 19 July 2008.

In addition, I have made the following changes:

1) Placed more comments in contour.py with the intention of eventually doing
a rewrite or restructuring of that code.

2) Added two pylab_examples: contour_label_demo.py that tests out some of the
more advanced things that can now be done with contour labeling, and
ginput_manual_clabel.py that demonstrates some uses of ginput,
waitforbuttonpress, and clabel(...,manual=True). The first of these has been
integrated into backend_driver.py, but the second cannot be because it
requires interaction.

Making a number of changes related to "blocking" stuff:

1) Adding to cbook.py a method is_sequence_of_strings that is then used in
BlockingInput to test for a tuple-like sequence of event names

2) Modified the use of *fmt* in clabel so that it an also be a
dictionary matching contour levels to arbitrary strings.

3) Removing the extraneous np.array or np.asarray commands in ContourLabeler
as they were forcing linecontour to array, but linecontour should already
be an array.

4) In blocking_input.py replacing all print commands with calls to
matplotlib.verbose.report

5) Removing extra cleanup call from BlockingInput as finally is always
executed, regardless of exception status.

6) Removing what appears to be a "patch" command screwup - there were two
versions of several of the Blocking* classes in blocking_input.py

Adding more functionality for interacting with figure windows through
mouse clicks and keyboard clicks. This includes adding a
waitforbuttonpress function, as well as manual contour label location
selection for clabel. The underlying Blocking* classes that drive
this interaction have been moved into a separate file
"lib/matplotlib/blocking_input.py". Also added a changelog entry.