added some fill demos

svn path=/trunk/matplotlib/; revision=545

Author: jdh2358

API_CHANGES

@@ -1,3 +1,45 @@
+API CHANGES in matplotlib-0.63
+
+  Dates are now represented internally as float days since 0001-01-01,
+  UTC.
+
+  All date tickers and formatters are now in matplotlib.dates, rather
+  than matplotlib.tickers
+
+  converters have been abolished from all functions and classes.
+  num2date and date2num are now the converter functions for all date
+  plots
+
+  Most of the date tick locators have a different meaning in their
+  constructors.  In the prior implementation, the first argument was a
+  base and multiples of the base were ticked.  Eg 
+
+    HourLocator(5)  # old: tick every 5 minutes
+
+  In the new implementation, the explicit points you want to tick are
+  provided as a number or sequence
+
+     HourLocator(range(0,5,61))  # new: tick every 5 minutes
+
+  This gives much greater flexibility.  I have tried to make the
+  default constructors (no args) behave similarly, where possible.
+
+  Note that YearLocator still works under the base/multiple scheme.
+  The difference between the YearLocator and the other locators is
+  that years are not recurrent.
+
+
+  Financial functions: 
+
+    matplotlib.finance.quotes_historical_yahoo(ticker, date1, date2)
+
+     date1, date2 are now datetime instances.  Return value is a list
+     of quotes where the quote time is a float - days since gregorian
+     start, as returned by date2num
+
+     See examples/finance_demo.py for example usage of new API
+
+
 API CHANGES in matplotlib-0.61
 
   canvas.connect is now deprecated for event handling.  use

INSTALL

@@ -45,12 +45,13 @@ COMPILING
   /some/path/include/somheader.h, put /some/path in the basedir list
   for your platform.
 
-  Note, matplotlib works with with Numeric or numarray, but it is
-  important that you set NUMERIX in setup.py to the array package you
-  typically use, for efficiency reasons.  For performace, it is
-  critical that the numerix settings in setup.py and in your
-  .matplotlibrc file are the same, and are the same as the array
-  package you typicaly use.
+  matplotlib works with with Numeric or numarray.  At compile time,
+  setup.py will look for both packages and compile the appropriate
+  extensions into matplotlib.  At runtime, the correct extension code
+  will be chosen based on your numerix setting in matplotlibrc.  If
+  you want to be able to use either Numeric or numarray efficiently
+  with matplotlib, it is important that you have *both* present and in
+  your PYTHONPATH when you compile matplotlib.
 
   Note that if you install matplotlib anywhere other than the default
   location, you will need to set the MATPLOTLIBDATA environment

examples/date_demo2.py

@@ -40,4 +40,5 @@
 set(labels, rotation=45)
 
 grid(True)
+savefig('date_demo2')
 show()

examples/fill_between.py

@@ -1,20 +1,14 @@
 from matplotlib.matlab import *
-from matplotlib.patches import Polygon
 
-def fill_between(ax, x, y1, y2, **kwargs):
-    # add x,y2 in reverse order
-    verts = zip(x,y1) + [(x[i], y2[i]) for i in range(len(x)-1,-1,-1)]
-    poly = Polygon(verts, **kwargs)
-    ax.add_patch(poly)
-    ax.autoscale_view()
-    return poly
+x1 = arange(0, 2, 0.01)
+y1 = sin(2*pi*x1)
+y2 = sin(4*pi*x1) + 2
 
-x = arange(0, 2, 0.01)
-y1 = sin(2*pi*x)
-y2 = sin(4*pi*x) + 2
-ax = gca()
-
-p = fill_between(ax, x, y1, y2, facecolor='g')
-p.set_alpha(0.5)
+# reverse x and y2 so the polygon fills in order
+x = concatenate( (x1,x1[::-1]) )
+y = concatenate( (y1,y2[::-1]) )
+                 
+p = fill(x, y, facecolor='g')
+set(p, alpha=0.5)
 show()
 

examples/fill_spiral.py

@@ -0,0 +1,22 @@
+from matplotlib.matlab import *
+
+theta = arange(0,8*pi,0.1)
+a=1
+b=.2
+
+for dt in arange(0,2*pi,pi/2.0):
+
+     x = a*cos( theta+dt )*exp(b*theta)
+     y = a*sin( theta+dt )*exp(b*theta)
+
+     dt = dt+pi/4.0
+
+     x2 = a*cos( theta+dt )*exp(b*theta)
+     y2 = a*sin( theta+dt )*exp(b*theta)
+
+     xf = concatenate( (x,x2[::-1]) )
+     yf = concatenate( (y,y2[::-1]) )
+
+     p1=fill(xf,yf)
+
+show()

lib/matplotlib/__init__.py

@@ -113,7 +113,7 @@
 the exception of those in mlab.py provided by matplotlib.
 """
 
-__version__  = '0.63.0a'
+__version__  = '0.63.0'
 __revision__ = '$Revision$'
 __date__     = '$Date$'